Commit Message

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?
H.J.
---
2013-11-08 H.J. Lu <hongjiu.lu@intel.com>
PR other/59055
* doc/gcc.texi: Move Trouble after Bugs in menu. Include
trouble.texi after bugreport.texi.
* doc/service.texi: Add next, previous and up nodes to Service
nodes.
* doc/trouble.texi: Add next, previous and up nodes to Trouble
nodes.

Comments

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?
That way you could omit
> 2013-11-08 H.J. Lu <hongjiu.lu@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
Gerald

On Mon, Dec 2, 2013 at 5:10 AM, Gerald Pfeifer <gerald@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.lu@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.