Rietveld Code Review Tool
Help | Bug tracker | Discussion group | Source code | Sign in
(937)

Issue 573000044: Improve generated documentation.

Can't Edit
Can't Publish+Mail
Start Review
Created:
4 years, 7 months ago by lemzwerg
Modified:
4 years, 7 months ago
Reviewers:
CC:
lilypond-devel_gnu.org
Visibility:
Public.

Description

Improve generated documentation. -------------------------------- For LilyPond commands, prepend a backslash to the command name. Don't emit @funindex and @cindex at the same time. Don't use @findex but @funindex. Better indexing support. ------------------------ In TeX output mode we unify `@findex', `@cindex', and `@vindex' entries in the concept index; this is done with the `@syncodeindex' lines in macro `@lilyTitlePage'. We also set `txiindexbackslashignore' so that `\foo' gets sorted as `foo'. However, the latter directive has the side effect that `\foo' and `foo' are treated as equal by the index sorting program. We don't want that: It is important for us that entries for both `\foo' and `foo' appear in the unified index. For this reason, we make macro `@funindex' use `@sortas' to set a special sorting key, and we redefine texinfo's internal macro `\indexwritesortas' to swallow backslashes. We also modify `@cindex' to insert another sorting key to ensure that `\foo' immediately comes after `foo', followed by entries like `foo bar'. Also add option `-8bit' to xe(la)tex to get real 8bit characters in auxiliary index files.

Patch Set 1 #

Patch Set 2 : Update commit message #

Patch Set 3 : Handle case where function name already starts with a backslash. #

Unified diffs Side-by-side diffs Delta from patch set Stats (+115 lines, -36 lines) Patch
M Documentation/common-macros.itexi View 3 chunks +75 lines, -3 lines 0 comments Download
M Documentation/macros.itexi View 2 chunks +6 lines, -11 lines 0 comments Download
M Documentation/notation.tely View 1 chunk +22 lines, -13 lines 0 comments Download
M scm/document-context-mods.scm View 1 chunk +2 lines, -2 lines 0 comments Download
M scm/document-identifiers.scm View 1 2 1 chunk +8 lines, -4 lines 0 comments Download
M scm/document-markup.scm View 1 chunk +0 lines, -1 line 0 comments Download
M scripts/build/xelatex-with-options.sh View 1 chunk +1 line, -1 line 0 comments Download
M scripts/build/xetex-with-options.sh View 1 chunk +1 line, -1 line 0 comments Download

Messages

Total messages: 3
lemzwerg
Update commit message
4 years, 7 months ago (2019-08-28 19:13:14 UTC) #1
lemzwerg
On 2019/08/28 19:13:14, lemzwerg wrote: > Update commit message Oh, this didn't work. So here ...
4 years, 7 months ago (2019-08-28 19:15:49 UTC) #2
lemzwerg
4 years, 7 months ago (2019-08-29 10:16:30 UTC) #3
Handle case where function name already starts with a backslash.
Sign in to reply to this message.

Powered by Google App Engine
RSS Feeds Recent Issues | This issue
This is Rietveld f62528b