[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[PATCH v4 0/3] docs: Document list of undocumented commands

From: Hans Ulrich Niedermann
Subject: [PATCH v4 0/3] docs: Document list of undocumented commands
Date: Mon, 11 May 2020 01:12:28 +0200

This patchset adds a script to the buildsystem which determines
the lists of GRUB commands implemented in the source code and
the list of GRUB commands documented in and documents
the differences.

For that matter, the script will autogenerate a list of the
undocumented commands to be included in, so that the
undocumented commands are at least listed there so users have
a point to start researching. If the command is at least
mentioned somewhere withing grub.texi, that will be noted.

The two commands pxe_unload and uppermem which were documented
in but not implemented in the source code are removed
from grub.texi in separate patches in the patchset.

The long term goal of this is to reduce the number of undocumented
GRUB commands to zero and to keep it there.

For conflict free merging, this patchset requires my gitignore
patchset as it adds a gitignore pattern for the file it generates.

Hans Ulrich Niedermann (3):
  docs: Add grub command documentation checks
  docs: Remove docs for non-existing pxe_unload command
  docs: Remove docs for non-existing uppermem command

 .gitignore             |   1 +
 docs/       |  18 +++-
 docs/ | 205 +++++++++++++++++++++++++++++++++++++++++
 docs/grub.texi         |  28 +-----
 4 files changed, 225 insertions(+), 27 deletions(-)
 create mode 100644 docs/

diff --git a/docs/ b/docs/
index 8e8500226..a8009e7a9 100644
--- a/docs/
+++ b/docs/
@@ -6,10 +6,12 @@ grub_TEXINFOS = fdl.texi undocumented-commands.texi
 EXTRA_DIST = font_char_metrics.png font_char_metrics.txt
+# This has only been tested to work without the Automake
+# info-in-builddir option.
 CLEANFILES = undocumented-commands.texi
 BUILT_SOURCES = update-undoc
-       $(PYTHON) > undocumented-commands.texi.tmp
+       $(PYTHON) $(srcdir)/ > undocumented-commands.texi.tmp
        @if test -f $(srcdir)/undocumented-commands.texi && $(CMP) 
undocumented-commands.texi.tmp $(srcdir)/undocumented-commands.texi; then \
                echo "Not updating undocumented-commands.texi: is up to date"; \
                rm -f undocumented-commands.texi.tmp; \

reply via email to

[Prev in Thread] Current Thread [Next in Thread]