Folks,


I suggest to add a second, optional argument to `@anchor` that gives
the default printed label.

Rationale: The `@node` command is tightly bound with a section command
like `@chapter`; this gets reflected by the command
`@xrefautomaticsectiontitle`, which makes `@xref` and friends actually
print the sectioning title instead of the node name.

For the `@anchor` command, however, there is no such pairing.  This
means that currently a third argument must be added to `@xref` to get
the desired effect.  I think this is both inconvenient and error
prone, especially if `@xrefautomaticsectiontitle` is set:

* A user has to know whether the target got created with `@node` or
  with `@anchor`; if it's the latter, `@xref` usually needs an
  additional argument to specify the printed label.

* If a node gets removed and replaced with an anchor, it is necessary
  to update all associated `@xref` commands to give them a third
  argument.

Having a second argument to `@anchor` to specify the default printed
label target would elegantly circumvent the described problems.  For
me, the most important advantage would be that an `@xref` command to
an anchor can be used in exactly the same way as with a reference to
`@node`.


    Werner

Reply via email to