OpenAFS Master Repository branch, master, updated. openafs-devel-1_9_2-207-g5d0dd65

Gerrit Code Review gerrit@openafs.org
Wed, 26 Mar 2025 11:27:00 -0400


The following commit has been merged in the master branch:
commit 8c0503522b4dec6f942f02e3710ba594a8af7a3c
Author: Michael Meffie <mmeffie@sinenomine.net>
Date:   Wed Mar 19 07:39:48 2025 -0400

    doc: Recusively include files in generate-pod
    
    The generate-pod processes include directives by copying the contents of
    the include file into the output pod without any further processing.
    
    Instead, treat the included content as a template too, by recursively
    calling the render() routine on the include file, up to a safety limit
    (currently 10).  This removes the single-level include limit and later
    allows us to add other templating support in the included files.
    
    - Add MAX_INCLUDE_LEVELS constant for the recursion safety check.
    
    - Add nested '=include' directive support, up to 10 levels.
    
    - Simplify the render() subroutine by removing unneeded `chdir` and
      `pwd` calls.
    
    - Add input file line number tracking for better error messages.
    
    - Add the binmode setting in the include files as is done for the main
      template files when running on Windows.
    
    Change-Id: I2ac744aed9ed8a46e5e523c9662fb4880c6474e5
    Reviewed-on: https://gerrit.openafs.org/16348
    Reviewed-by: Cheyenne Wills <cwills@sinenomine.net>
    Tested-by: BuildBot <buildbot@rampaginggeek.com>
    Reviewed-by: Michael Meffie <mmeffie@sinenomine.net>

 doc/man-pages/generate-pod | 48 ++++++++++++++++++++++------------------------
 1 file changed, 23 insertions(+), 25 deletions(-)

-- 
OpenAFS Master Repository