Now builds for all formats and includes urls

1998-04-14 15:32:28 +00:00
parent 6cede6e403
commit dff0a57c2b
4 changed files with 76 additions and 32 deletions
--- a/doc/started/buildc.t
+++ b/doc/started/buildc.t
@@ -107,17 +107,26 @@ specific patches.
    FTP Site:    @value{RTEMS-FTPSITE}
    Directory:   @value{RTEMS-FTPDIR}
    File:        @value{RTEMS-TAR}
-    File:        hello_world_c.tgz
-    File:        bit
@ifset use-html
    URL:         @href{Download RTEMS components,,,ftp://@value{RTEMS-FTPSITE}@value{RTEMS-FTPDIR}}
@end ifset
@end example

-@subheading RTEMS Specific Tool Patches
+@subheading RTEMS Hello World
+@example
+    FTP Site:    @value{RTEMS-FTPSITE}
+    Directory:   @value{RTEMS-FTPDIR}
+    File:        hello_world_c.tgz
+@ifset use-html
+    URL:         @href{Download RTEMS Hello World,,,ftp://@value{RTEMS-FTPSITE}@value{RTEMS-FTPDIR}/hello_world_c.tgz}
+@end ifset
+@end example
+
+@subheading RTEMS Specific Tool Patches and Scripts
@example
    FTP Site:    @value{RTEMS-FTPSITE}
    Directory:   @value{RTEMS-FTPDIR}/c_tools
+    File:        bit
@ifset BINUTILS-RTEMSPATCH
    File:        @value{BINUTILS-RTEMSPATCH}
@end ifset
@@ -127,15 +136,9 @@ specific patches.
@ifset GCC-RTEMSPATCH
    File:        @value{GCC-RTEMSPATCH}
@end ifset
-    URL:         @href{Download RTEMS patches,,,ftp://@value{RTEMS-FTPSITE}@value{RTEMS-FTPDIR}/c_tools}
-@c Just in case there are ever no patches
-@ifclear BINUTILS-RTEMSPATCH
-@ifclear GCC-RTEMSPATCH
-@ifclear NEWLIB-RTEMSPATCH
-    No RTEMS specific patches are required.
-@end ifclear
-@end ifclear
-@end ifclear
+@ifset use-html
+    URL:         @href{Download RTEMS Patches and Scripts,,,ftp://@value{RTEMS-FTPSITE}@value{RTEMS-FTPDIR}/c_tools}
+@end ifset
@end example

@section Unarchiving the Tools
--- a/doc/started/nt.t
+++ b/doc/started/nt.t
@@ -65,7 +65,14 @@ save files with Unix format (so don't use Notepad
 nor Wordpad). If you do not have an appropriate
 text editor, try @b{Programmers File Editor}, it is
 free and very convenient.  This editor may be downloaded
-from @href{@value{PFE-FTP},,@value{PFE-FTP}}.
+from:
+
+@ifset use-html
+@href{@value{PFE-FTP},,@value{PFE-FTP}}
+@end ifset
+@ifclear use-html
+@value{PFE-FTP}
+@end ifclear

@subsection Bug in Patch Utility

@@ -76,12 +83,19 @@ Unix format, so a @code{dos2unix}-like command must
 be used to put them back into Unix format as shown below:

@example
-dos2unix XXX
+$ dos2unix XYZ
+Dos2Unix: Cleaning file XYZ ...
@end example

 The dos2unix utility may be downloaded from:

-@href{@value{DOS2UNIX-FTP},,,@value{DOS2UNIX-FTP}}.
+@ifset use-html
+@href{@value{DOS2UNIX-FTP},,,@value{DOS2UNIX-FTP}}
+@end ifset
+@ifclear use-html
+@value{DOS2UNIX-FTP}
+@end ifclear
+

@subsection Files Needed

@@ -96,10 +110,20 @@ Web browser or ftp client.
@table @b

@item cdk.exe
-@ref{@value{CYGWIN-FTP},,@value{CYGWIN-FTP}}
+@ifset use-html
+@href{@value{CYGWIN-FTP},,@value{CYGWIN-FTP}}
+@end ifset
+@ifclear use-html
+@value{CYGWIN-FTP}
+@end ifclear

@item usertools.exe
-@ref{@value{CYGWIN-FTP},,@value{CYGWIN-FTP}}
+@ifset use-html
+@href{@value{CYGWIN-FTP},,@value{CYGWIN-FTP}}
+@end ifset
+@ifclear use-html
+@value{CYGWIN-FTP}
+@end ifclear

@end table

--- a/doc/started_ada/buildada.t
+++ b/doc/started_ada/buildada.t
@@ -66,7 +66,7 @@ one shown in the following figure:
@end html
@end ifset

-@section Get all the Pieces 
+@section Get All the Pieces 

 This section lists the components of an RTEMS cross development system.
 Included are the locations of each component as well as any required RTEMS
@@ -77,6 +77,9 @@ specific patches.
    FTP Site:    @value{GCC-FTPSITE}
    Directory:   @value{GCC-FTPDIR}
    File:        @value{GCC-TAR}
+@ifset use-html
+    URL:         @href{Download @value{GCC-VERSION},,,ftp://@value{GCC-FTPSITE}@value{GCC-FTPDIR}/@value{GCC-TAR}}
+@end ifset
@end example

@subheading @value{GNAT-VERSION}
@@ -84,6 +87,9 @@ specific patches.
    FTP Site:    @value{GNAT-FTPSITE}
    Directory:   @value{GNAT-FTPDIR}
    File:        @value{GNAT-TAR}
+@ifset use-html
+    URL:         @href{Download @value{GNAT-VERSION},,,ftp://@value{GNAT-FTPSITE}@value{GNAT-FTPDIR}/@value{GNAT-TAR}}
+@end ifset
@end example

@subheading @value{BINUTILS-VERSION}
@@ -91,6 +97,9 @@ specific patches.
    FTP Site:    @value{BINUTILS-FTPSITE}
    Directory:   @value{BINUTILS-FTPDIR}
    File:        @value{BINUTILS-TAR}
+@ifset use-html
+    URL:         @href{Download @value{BINUTILS-VERSION},,,ftp://@value{BINUTILS-FTPSITE}@value{BINUTILS-FTPDIR}/@value{BINUTILS-TAR}}
+@end ifset
@end example

@subheading @value{NEWLIB-VERSION}
@@ -98,6 +107,9 @@ specific patches.
    FTP Site:    @value{NEWLIB-FTPSITE}
    Directory:   @value{NEWLIB-FTPDIR}
    File:        @value{NEWLIB-TAR}
+@ifset use-html
+    URL:         @href{Download @value{NEWLIB-VERSION},,,ftp://@value{NEWLIB-FTPSITE}@value{NEWLIB-FTPDIR}/@value{NEWLIB-TAR}}
+@end ifset
@end example

@subheading @value{RTEMS-VERSION}
@@ -105,14 +117,26 @@ specific patches.
    FTP Site:    @value{RTEMS-FTPSITE}
    Directory:   @value{RTEMS-FTPDIR}
    File:        @value{RTEMS-TAR}
-    File:        bit_ada
-    File:        hello_world_ada.tgz
+@ifset use-html
+    URL:         @href{Download RTEMS components,,,ftp://@value{RTEMS-FTPSITE}@value{RTEMS-FTPDIR}}
+@end ifset
@end example

-@subheading RTEMS Specific Tool Patches
+@subheading RTEMS Hello World
+@example
+    FTP Site:    @value{RTEMS-FTPSITE}
+    Directory:   @value{RTEMS-FTPDIR}
+    File:        hello_world_ada.tgz
+@ifset use-html
+    URL:         @href{Download RTEMS Hello World,,,ftp://@value{RTEMS-FTPSITE}@value{RTEMS-FTPDIR}/ada_tools/hello_world_ada.tgz}
+@end ifset       
+@end example
+
+@subheading RTEMS Specific Tool Patches and Scripts
@example
    FTP Site:    @value{RTEMS-FTPSITE}
    Directory:   @value{RTEMS-FTPDIR}/ada_tools
+    File:        bit_ada
@ifset BINUTILS-RTEMSPATCH
    File:        @value{BINUTILS-RTEMSPATCH}
@end ifset
@@ -125,15 +149,8 @@ specific patches.
@ifset GNAT-RTEMSPATCH
    File:        @value{GNAT-RTEMSPATCH}
@end ifset
-@c Just in case there are ever no patches
-@ifset BINUTILS-RTEMSPATCH
-@ifset GCC-RTEMSPATCH
-@ifset NEWLIB-RTEMSPATCH
-@ifset GNAT-RTEMSPATCH
-    No RTEMS specific patches are required.
-@end ifset
-@end ifset
-@end ifset
+@ifset use-html
+    URL:         @href{Download RTEMS patches,,,ftp://@value{RTEMS-FTPSITE}@value{RTEMS-FTPDIR}/ada_tools}
@end ifset
@end example

--- a/doc/started_ada/buildrt.t
+++ b/doc/started_ada/buildrt.t
@@ -43,9 +43,9 @@ function in a file named @code{f.c}:

@example
 int f( int x )
-{
+@{
  return x + 1; 
-}
+@}
@end example

 Then assemble the file using a command similar to the following: