On Wed, 31 Jan 2024 00:49:09 GMT, Jonathan Gibbons <j...@openjdk.org> wrote:
> Please review a small change, at least as a "proof of concept", to allow > customized options to be given to `pandoc` based on the module and filename > for a spec. > > The goal is to allow a Markdown spec file to have an auto-generated > table-of-contents, by including the `--toc` option when running pandoc for > specific documents. > > There may be better ways to achieve this goal; while I have a working > knowledge of this makefile, I'm not an expert. In particular, I tried to find > a way to defer the evaluation of the option, so that the declaration of the > value did not have to appear before its use in the macros. But I could only > get it to work as presented here. > > No other support for a TOC is needed, since we already generate TOCs for > other pages, like tool guides (man pages.) Yeah, right, make sure you have the following block in your md file: --- # Copyright (c) 1993, 2023, Oracle and/or its affiliates. All rights reserved. ... _pandoc-options_: --toc --- ------------- PR Comment: https://git.openjdk.org/jdk/pull/17642#issuecomment-1918815081