This is the mail archive of the mailing list for the GCC project.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Documentation patch: formatting of URLs in Texinfo manual

There is some inconsistency in the manual in how URLs are marked up.
The presently best Texinfo form seems to be @uref; this patch causes
it to be used consistently.  (The G77 manual already does use it

@uref has forms allowing a link text to be provided as well as the
URL, but I haven't used them.  Some URLs may be out of date.  I think
all the URL references are best as links rather than as plain
references as would be given by @url according to current Texinfo.

This patch passes "make info".  OK to commit?

2000-09-27  Joseph S. Myers  <>

	* extend.texi, invoke.texi, gcc.texi, install.texi: Consistently
	use @uref for formatting URLs.

--- extend.texi.orig	Wed Sep  6 23:11:23 2000
+++ extend.texi	Wed Sep 27 15:03:26 2000
@@ -420,7 +420,7 @@
 GNU CC implements taking the address of a nested function using a
 technique called @dfn{trampolines}.   A paper describing them is
-available as @samp{}.
+available as @uref{}.
 A nested function can jump to a label inherited from a containing
 function, provided the label was explicitly declared in the containing
--- invoke.texi.orig	Tue Sep 26 08:12:15 2000
+++ invoke.texi	Wed Sep 27 15:03:34 2000
@@ -740,7 +740,7 @@
 @item iso9899:1999
 ISO C99.  Note that this standard is not yet fully supported; see
-@url{} for more information.
+@uref{} for more information.
 @item c89
 same as -std=iso9899:1990
--- gcc.texi.orig	Mon Aug 21 18:34:34 2000
+++ gcc.texi	Wed Sep 27 15:05:40 2000
@@ -652,11 +652,10 @@
 ./xgcc: Internal compiler error: program as got fatal signal 11
 @end smallexample
-A patched version of the assembler is available by anonymous ftp from
-@code{} as the file
-@file{archive/cph/hpux-8.0-assembler}.  If you have HP software support,
-the patch can also be obtained directly from HP, as described in the
-following note:
+A patched version of the assembler is available as the file
+@uref{}.  If you
+have HP software support, the patch can also be obtained directly from
+HP, as described in the following note:
 This is the patched assembler, to patch SR#1653-010439, where the
@@ -2236,7 +2235,7 @@
 to @samp{}, the address @samp{}
 may also be used; it will forward to the address given above.
-Please read @samp{<URL:>} for
+Please read @uref{} for
 bug reporting instructions before you post a bug report.
 Often people think of posting bug reports to the newsgroup instead of
@@ -2260,7 +2259,7 @@
 @cindex compiler bugs, reporting
 You may find additional and/or more up-to-date instructions at
 The fundamental principle of reporting bugs usefully is this:
 @strong{report all the facts}.  If you are not sure whether to state a
--- install.texi.orig	Thu Sep 14 07:49:35 2000
+++ install.texi	Wed Sep 27 15:08:25 2000
@@ -852,7 +852,7 @@
 The MIL-STD-1750A cross configuration produces output for
 @code{as1750}, an assembler/linker available under the GNU Public
 License for the 1750A. @code{as1750} can be obtained at 
 A similarly licensed simulator for
 the 1750A is available from same address.
@@ -957,7 +957,7 @@
 Any of the ARM-family processors running the Linux-based GNU system with
 the @file{ELF} binary format.  You must use version or later
 of the GNU/Linux binutils, which you can download from
 These two configurations differ only in the required version of GNU
 binutils.  For binutils, use @samp{arm-*-linux-gnuoldld}.  For 
@@ -970,7 +970,7 @@
 assembler shipped with RISC iX does not support stabs debugging
 information; a new version of the assembler, with stabs support
 included, is now available from Acorn and via ftp
-@file{}.  To enable stabs
+@uref{}.  To enable stabs
 debugging, pass @samp{--with-gnu-as} to configure.
 You will need to install GNU @file{sed} before you can run configure.
@@ -1179,7 +1179,7 @@
 @item i[345]86-*-winnt3.5
 This version requires a GAS that has not yet been released.  Until it
 is, you can get a prebuilt binary version via anonymous ftp from
-@file{} or @file{}. You
+@uref{} or @uref{}. You
 must also use the Microsoft header files from the Windows NT 3.5 SDK.
 Find these on the CDROM in the @file{/mstools/h} directory dated 9/4/94.  You
 must use a fixed version of Microsoft linker made especially for NT 3.5,
@@ -1276,7 +1276,7 @@
 be compiled with the system C compiler, which is too buggy.
 You will need to get a previous version of GCC and use it to
 bootstrap.  Binaries are available from the OSU-CIS archive, at
 @item m68k-bull-sysv
 Bull DPX/2 series 200 and 300 with BOS-2.00.45 up to BOS-2.01. GNU CC works

Joseph S. Myers

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]