]> git.proxmox.com Git - mirror_frr.git/commitdiff
2004-11-07 Paul Jakma <paul@dishone.st>
authorpaul <paul>
Sun, 7 Nov 2004 19:39:13 +0000 (19:39 +0000)
committerpaul <paul>
Sun, 7 Nov 2004 19:39:13 +0000 (19:39 +0000)
* Makefile.am: Add automatic rule to build pdf's from eps figures.
  Clean *.pdf. Add rule for quagga.pdf (as the eps.pdf pattern
          probably otherwise will override automake's rule for quagga.pdf)
* overview.texi: URL was causing TeX overfull, put on newline.
* quagga.texi: Put the copyright notice into @copying section, as
  is proper. Strip trailling space from the main menu lines.
* rip(ng)?d.texi: Minor reformatting.
* Add the route server docs.
* bgpd.texi: remove unneeded page breaks. The 6Bone example
          overflows though.

doc/.cvsignore
doc/ChangeLog
doc/Makefile.am
doc/bgpd.texi
doc/overview.texi
doc/quagga.texi
doc/ripd.texi
doc/ripngd.texi

index 1b6e6bc4e0d364dbb14d1f49b4cb611f422d2ca3..449c7ae997a9486b408ef23650305e287e0b054b 100644 (file)
@@ -8,7 +8,7 @@ defines.texi
 version.texi
 quagga.info*
 quagga.html
-quagga.pdf
+*.pdf
 quagga.ps
 quagga.dvi
 stamp-vti
index 7175a09ed1c8f871d2d3da459ffd73ca84411147..5d8a570b8708506f6fad73f0cc62ff56312df8b0 100644 (file)
@@ -1,6 +1,15 @@
 2004-11-07 Paul Jakma <paul@dishone.st>
 
+       * Makefile.am: Add automatic rule to build pdf's from eps figures.
+         Clean *.pdf. Add rule for quagga.pdf (as the eps.pdf pattern
+          probably otherwise will override automake's rule for quagga.pdf)
+       * overview.texi: URL was causing TeX overfull, put on newline.
+       * quagga.texi: Put the copyright notice into @copying section, as
+         is proper. Strip trailling space from the main menu lines.
+       * rip(ng)?d.texi: Minor reformatting.
        * Add the route server docs.
+       * bgpd.texi: remove unneeded page breaks. The 6Bone example
+          overflows though.
        * routeserver.texi: new file, texinfo'fied and slightly modified 
           version of the original TeX from James Luis Rubio.
        * fig-*.eps: new files, diagrammes.
index 916450f37f0fe03897e72b747104112705bf317d..bcf55e24f2cfe156d2d3db7bd25fb71ec482e2ea 100644 (file)
@@ -1,13 +1,41 @@
 ## Process this file with automake to produce Makefile.in.
 
-info_TEXINFOS = quagga.texi
+EPSTOPDF = epstopdf
+
+# rather twisted logic because we have to build PDFs of the EPS figures
+# and yet build one PDF, quagga.pdf, from texi source. Which means we cant
+# rely on a single automatic rule for *.pdf.
+# If you are an automake wizard, please feel free to compact it somehow.
+#figures_pdfs = Normal-Announcement-processing.eps \
+#             RS-Announcement-processing.eps \
+#             topologias_full.eps topologias_rs.eps 
 
+# Built from defines.texi.in
 BUILT_SOURCES = defines.texi
 
+info_TEXINFOS = quagga.texi
+
+CLEANFILES = *.pdf
+
+# The figure sources
+figures_SOURCES = fig-normal-processing.eps \
+                 fig_topologies_full.eps \
+                 fig-rs-processing.eps \
+                 fig_topologies_rs.eps
+
+# Have to manually               
+quagga.pdf: quagga.texi \
+            fig-normal-processing.pdf fig_topologies_full.pdf \
+           fig-rs-processing.pdf fig_topologies_rs.pdf
+       $(TEXI2PDF) -o "$@" $(info_TEXINFOS)
+
 quagga_TEXINFOS = appendix.texi basic.texi bgpd.texi filter.texi install.texi \
        ipv6.texi kernel.texi main.texi ospf6d.texi ospfd.texi overview.texi \
        protocol.texi ripd.texi ripngd.texi routemap.texi snmp.texi vtysh.texi \
-       defines.texi
+       defines.texi $(figures_SOURCES)
+
+%.pdf: %.eps
+       $(EPSTOPDF) --outfile="$@" $<
 
 man_MANS = vtysh.1 bgpd.8 ospf6d.8 ospfd.8 ripd.8 ripngd.8 zebra.8
 
index dab367c0a2bd9045529afa4a2f17e324dbbe4bd2..0e0a2708a0f2327242345d3e02f17f062bcb4bd4 100644 (file)
@@ -328,9 +328,6 @@ This command bind specific peer to peer group @var{word}.
 @node BGP Address Family
 @section BGP Address Family
 
-
-
-@page
 @c -----------------------------------------------------------------------
 @node Autonomous System
 @section Autonomous System
@@ -422,7 +419,6 @@ This command defines a new AS path access list.
 @node Private AS Numbers
 @subsection Private AS Numbers
 
-@page
 @c -----------------------------------------------------------------------
 @node BGP Communities Attribute
 @section BGP Communities Attribute
@@ -1182,6 +1178,7 @@ Display routing table of BGP view @var{name}.
 @node How to set up a 6-Bone connection
 @section How to set up a 6-Bone connection
 
+
 @example
 @group
 zebra configuration 
index 1298037915d0a3c38116250317201c4131a19371..911553f9523f2ef675e282b4f3c3a78856722228 100644 (file)
@@ -304,9 +304,11 @@ the available mailing lists, see:
 @cindex Reporting software errors
 @cindex Errors in the software
 
-  If you think you have found a bug, please send a bug report to
-@uref{http://bugzilla.quagga.net}. When you send a bug report, please be
-careful about the points below.
+If you think you have found a bug, please send a bug report to:
+
+@uref{http://bugzilla.quagga.net}
+
+When you send a bug report, please be careful about the points below.
 
 @itemize @bullet
 @item 
index 18d52d5f2cab341c8354b1a20f3ce47572d5975d..cd3b5f2f3e7bddecfe9cb64dc1fe8e75eb7fafc7 100644 (file)
 @c and set EDITION, VERSION, UPDATED and UPDATED-MONTH
 @include version.texi
 
+@copying
+@quotation
+Permission is granted to make and distribute verbatim copies of this
+manual provided the copyright notice and this permission notice are
+preserved on all copies.
+
+Permission is granted to copy and distribute modified versions of this
+manual under the conditions for verbatim copying, provided that the
+entire resulting derived work is distributed under the terms of a
+permission notice identical to this one.
+
+Permission is granted to copy and distribute translations of this manual
+into another language, under the above conditions for modified versions,
+except that this permission notice may be stated in a translation
+approved by Kunihiro Ishiguro.
+@end quotation
+@end copying
+
 @c Info entry
 @dircategory Routing Software:
 @direntry
-* Quagga: (quagga).            The Quagga routing software
+* Quagga: (quagga).            The Quagga Software Routing Suite
 @end direntry
 
 @c @smallbook
 
 @ifinfo
-This file documents the @sc{gnu} Quagga software which manages common
+This file documents the Quagga Software Routing Suite which manages common
 TCP/IP routing protocols.
 
 This is Edition @value{EDITION}, last updated @value{UPDATED} of
@@ -32,26 +50,7 @@ Version @value{VERSION}.
 
 @value{COPYRIGHT_STR}
 
-Permission is granted to make and distribute verbatim copies of this
-manual provided the copyright notice and this permission notice are
-preserved on all copies.
-
-@ignore
-Permission is granted to process this file through TeX and print the
-results, provided the printed document carries a copyright permission
-notice identical to this one except for the removal of this paragraph
-(this paragraph not being relevant to the printed manual).
-
-@end ignore
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided that the
-entire resulting derived work is distributed under the terms of a
-permission notice identical to this one.
-
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions,
-except that this permission notice may be stated in a translation
-approved by Kunihiro Ishiguro.
+@insertcopying
 @end ifinfo
 
 @titlepage
@@ -65,19 +64,7 @@ approved by Kunihiro Ishiguro.
 @vskip 0pt plus 1filll
 @value{COPYRIGHT_STR}
 
-Permission is granted to make and distribute verbatim copies of
-this manual provided the copyright notice and this permission notice
-are preserved on all copies.
-
-Permission is granted to copy and distribute modified versions of this
-manual under the conditions for verbatim copying, provided that the entire
-resulting derived work is distributed under the terms of a permission
-notice identical to this one.
-
-Permission is granted to copy and distribute translations of this manual
-into another language, under the above conditions for modified versions,
-except that this permission notice may be stated in a translation approved
-by Kunihiro Ishiguro.
+@insertcopying
 @end titlepage
 @page
 
@@ -92,25 +79,26 @@ for quagga-@value{VERSION}. @uref{http://www.quagga.net,,Quagga} is a fork of
 @end ifnottex
 
 @menu
-* Overview::                    
-* Installation::                
-* Basic commands::              
-* Zebra::                       
-* RIP::                         
-* RIPng::                       
-* OSPFv2::                      
-* OSPFv3::                      
-* BGP::                         
-* VTY shell::                       
-* Filtering::                   
-* Route Map::                   
-* IPv6 Support::                
-* Kernel Interface::            
-* SNMP Support::                
-* Zebra Protocol::              
-* Packet Binary Dump Format::   
-* Command Index::               
-* VTY Key Index::               
+* Overview::
+* Installation::
+* Basic commands::
+* Zebra::
+* RIP::
+* RIPng::
+* OSPFv2::
+* OSPFv3::
+* BGP::
+* Configuring Quagga as a Route Server::
+* VTY shell::
+* Filtering::
+* Route Map::
+* IPv6 Support::
+* Kernel Interface::
+* SNMP Support::
+* Zebra Protocol::
+* Packet Binary Dump Format::
+* Command Index::
+* VTY Key Index::
 @end menu
 @contents
 
index 8874bc43da3e965234ea7e0662edf2b4edd0348d..c1ddfd1bd78077d20c6f20f3b646b01b8b5e3654 100644 (file)
@@ -3,7 +3,6 @@
 @c @value{COPYRIGHT_STR}
 @c See file quagga.texi for copying conditions.
 @node RIP
-@comment  node-name,  next,  previous,  up
 @chapter RIP
 
 RIP -- Routing Information Protocol is widely deployed interior gateway
@@ -567,9 +566,9 @@ dump is shown.
 Debug rip between zebra communication.
 @end deffn
 
-This command will show the communication between @command{ripd} and @command{zebra}.  The
-main information will include addition and deletion of paths to the
-kernel and the sending and receiving of interface information.
+This command will show the communication between @command{ripd} and
+@command{zebra}.  The main information will include addition and deletion of
+paths to the kernel and the sending and receiving of interface information.
 
 @deffn Command {show debugging rip} {}
 Display @command{ripd}'s debugging option.
index 433f1ab4399074327439b5c588d334fdc856e921..0e58de6da36edb66b5937cd87794c67df659175d 100644 (file)
@@ -1,3 +1,7 @@
+@c -*-texinfo-*-
+@c This is part of the Quagga Manual.
+@c @value{COPYRIGHT_STR}
+@c See file quagga.texi for copying conditions.
 @node RIPng
 @chapter RIPng