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

[Richard Stallman]

[[[ To any NSA and FBI agents reading my email: please consider    ]]]
[[[ whether defending the US Constitution against all enemies,     ]]]
[[[ foreign or domestic, requires you to follow Snowden's example. ]]]

Theis problem is in doc/misc/modus-themes.texi,
but I suspect that doc/misc/org.texi has it too.

The problem is that the file uses the wrong Texinfo markup in some
places.  I suspect that the source markup language, from which this
Texinfo text is generated, doesn't have the ability to make all the
distinctions Texinfo needs.


Here's an example from modus-themes.texi:

    Prior to querying any package archive, make sure to have updated the
    index, with @samp{M-x package-refresh-contents}.  Then all you need to do is
    type @samp{M-x package-install} and specify the theme of your choice.

@samp is incorrect here.  If it is M-x package-install RET, that is
keyboard input so it ashould be written in @kbd.  On the other hand,
package-install without M-x and RET is a command name and should be
inside @code.

Later on:

    If you set @samp{calendar-latitude} and @samp{calendar-longitude} (defined 
in the
    built-in @samp{solar.el} library---read it with @samp{M-x find-library}), 
you c

calendar-longitude is a symbol; it should be in @code.
solar.el is a file name; it should be in @file.

    The symbols ``subtle'' and ``intense'' will apply a combination of accented

Those symbol names should be in @code, not doublequotes.





-- 
Dr Richard Stallman
Chief GNUisance of the GNU Project (https://gnu.org)
Founder, Free Software Foundation (https://fsf.org)
Internet Hall-of-Famer (https://internethalloffame.org)