Fix documentation issues reported by Olaf
Get series with b4
b4 am [email protected]Versions newest first · linked by author and title
- v2 Latest2 patches 5 repliesIn review
- v12 patches 3 repliesSuperseded
Patches in v2 No applies recorded yet
| # | Subject and files | Size | Replies | Applied |
|---|---|---|---|---|
| 1/2 | docs: Use @ref instead of @xrefdocs/ | +1 | 0 replies | |
| 2/2 | docs: Add menu to prevent older makeinfo versions from failingdocs/ | +5 | 0 replies |
Reviews trailers per patch
None of the 2 patches has a Reviewed-by or Acked-by of their own; the series has one for all of them.
| Patch | Oskari Pirhonen | Daniel Kiper |
|---|---|---|
| Series | R-b | R-b |
| 1/2 | ||
| 2/2 |
Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.
Cover letter [PATCH v2 0/2] Fix documentation issues reported by Olaf
Updates from v1:
* Use @ref instead of @pxref as suggested by Oskari
Olaf, would you see if this updated patch series fixes your issues?
Glenn
Glenn Washburn (2):
docs: Use @ref instead of @xref
docs: Add menu to prevent older makeinfo versions from failing
docs/grub-dev.texi | 5 +++++ docs/grub.texi | 2 +- 2 files changed, 6 insertions(+), 1 deletion(-)
Range-diff against v1:
1: d85c7efc5681 ! 1: 9b49f9ab7319 docs: Use @pxref instead of @xref inside parenthesis
@@ Metadata
Author: Glenn Washburn <[email protected]>
## Commit message ##
- docs: Use @pxref instead of @xref inside parenthesis
+ docs: Use @ref instead of @xref
The @xref command is meant to be used at the beginning of a sentence
- because its expansion creates a "See " prefix. The @pxref expands with
- a prefix of "see " and is meant to be used within parenthesis. This also
- fixes an issue where there was a repeated "see" in the output.
+ because its expansion creates a "See " prefix on all output formats, and
+ on older makeinfo versions is strict about enforcing a '.' or ',' after
+ the command. The @ref command has no such restriction and is just the
+ link, which allows more control over output. This also fixes an issue
+ where there was a repeated "see" in the output.
@@ docs/grub.texi: information.
GRUB can be run in userspace by invoking the grub2-emu tool. It will
-read all configuration scripts as if booting directly (see @xref{Loading
-+read all configuration scripts as if booting directly (@pxref{Loading
++read all configuration scripts as if booting directly (see @ref{Loading
an operating system directly}). With the @code{--kexec} flag, and
kexec(8) support from the operating system, the @command{linux} command
will directly boot the target image. For systems that lack working
2: bb2ddd029460 = 2: de20b4cddba8 docs: Add menu to prevent older makeinfo versions from failing
Signature · 7 lines
2.34.1 _______________________________________________ Grub-devel mailing list [email protected] https://lists.gnu.org/mailman/listinfo/grub-devel