bug#45143: Incorrect markup in some doc/misc manuals

[Protesilaos Stavrou <info@protesilaos.com>]

On 2021-02-26, 22:49 -0500, Glenn Morris <rgm@gnu.org> wrote:

> I felt like this report wasn't going anywhere, so I fixed it
> myself in 3984044ad3..b3d310fa96 and will close this report.

Thank you!  So commit 3984044ad3 means that I should be contributing the
.org version of my manual from now on.

> I could not find a version of modus-themes.org that precisely
> corresponded to the modus-themes.texi in Emacs.

This is because I had made a few changes to that version that manually
fixed .texi markup and adjusted a few things to work with the emacs.git
build requirements.

For the forthcoming version 1.2.0 of my project I have, in principle,
addressed all markup-related issues and I will share this work soon
(contingent on bug#45068).  Though there will still have to be some
patches that are specific to emacs.git:

+ The "@setfilename" needs to be defined as a relative path.  This
  corresponds to the "#+TEXINFO_FILENAME:" in the Org format, which is
  not in the file now in Emacs (maybe this step can be skipped?).

+ An "@include emacsver.texi" has to be inserted right after the
  header.

+ The GNU Free Documentation License has to be added by means of
  "@include doclicense.texi".

I cannot maintain those minor extras in my git repo because they do not
work outside the build requirements of emacs.git (unless there is a way
to handle this conditionally and I am unaware of it).

-- 
Protesilaos Stavrou
protesilaos.com