On Mon, Dec 2, 2013 at 5:10 AM, Gerald Pfeifer <ger...@pfeifer.com> wrote: > On Fri, 8 Nov 2013, H.J. Lu wrote: >> bugreport.texi has >> >> @menu >> * Criteria: Bug Criteria. Have you really found a bug? >> * Reporting: Bug Reporting. How to report a bug effectively. >> * Known: Trouble. Known problems. >> * Help: Service. Where to ask for help. >> @end menu >> >> That means include order should be bugreport.texi, trouble.texi, >> service.texi. And we need to specify next, previous and up nodes to >> Service and Trouble nodes. OK to install? > > Thanks for looking into this, H.J.! Looking at the logic we have > been using elsewhere, I am wondering whether it shouldn't be the > order in bugreport.texi that should be adjusted -- switching the > "Known: Trouble" and "Reporting: Bug Reporting" nodes?
It doesn't work: /export/gnu/import/git/gcc/gcc/doc/trouble.texi:5: warning: node next `Trouble' in menu `Service' and in sectioning `Bugs' differ /export/gnu/import/git/gcc/gcc/doc/trouble.texi:5: warning: node prev `Trouble' in menu `Bug Reporting' and in sectioning `Gcov' differ /export/gnu/import/git/gcc/gcc/doc/trouble.texi:5: warning: node up `Trouble' in menu `Bugs' and in sectioning `Top' differ /export/gnu/import/git/gcc/gcc/doc/service.texi:5: warning: node prev `Service' in menu `Trouble' and in sectioning `Bugs' differ /export/gnu/import/git/gcc/gcc/doc/service.texi:5: warning: node up `Service' in menu `Bugs' and in sectioning `Top' differ > That way you could omit > >> 2013-11-08 H.J. Lu <hongjiu...@intel.com> >> >> PR other/59055 >> * doc/gcc.texi: Move Trouble after Bugs in menu. Include >> trouble.texi after bugreport.texi. > > those two changes, and only update bugreport.texi? If this sounds > acceptable, please go ahead and make this change. > >> * doc/service.texi: Add next, previous and up nodes to Service >> nodes. >> * doc/trouble.texi: Add next, previous and up nodes to Trouble >> nodes. > > Why are these necessary? The texinfo documentation say the following > about @node: > > The subsequent arguments are optional—they are the names of the > ‘Next’, ‘Previous’, and ‘Up’ pointers, in that order. We strongly > recommend omitting them if your Texinfo document is hierarchically > organized, as virtually all are > gcc.texi has @include gcov.texi @include trouble.texi @include bugreport.texi @include service.texi and there is a menu in bugreport.texi as well as @node Bug Criteria,Bug Reporting,,Bugs @node Bug Reporting,,Bug Criteria,Bugs They aren't really hierarchically organized. H.J.
