Hi All, >>>>> Arash Esbati <ar...@gnu.org> writes: > Tassilo Horn <t...@gnu.org> writes: >> Aren't INSTALL, TODO, FAQ, and CHANGES just the text versions of the >> corresponding texi/info files that are included in the manual anyway?
> Yes, this is my understanding.
>> I wonder why someone would look at them when the fine manual is
>> already there.
> I agree for TODO and FAQ, but I look usually for INSTALL and CHANGES as
> text files when I unpack something; maybe it is just a habit.
Then I suppose we can just discard these rules and should revise the
document. I attach a WIP patch.
In addition, it seems to me that we can delete yet more files on main
branch.
- RELEASE
- ChangeLog-preview
- changeLog-preview.1
- doc/copying.texi because it discusses only preview-latex, not AUCTeX
as a whole, and it isn't the same as COPYING, and it isn't included in
any other texinfo files.
What do you think?
>> Or we convert NEWS.org into some NEWS.texi file using some incantation
>> of "emacs -Q --batch -f org-texinfo-export-to-texinfo-batch ..."
> I had to do:
> emacs -Q --batch --eval "(require 'ox-texinfo)" \
> -f org-texinfo-export-to-texinfo-batch NEWS.org NEWS.texi
>> and include that in place of changes.texi. (It would be even better
>> when we somehow add the entries from changes.texi in NEWS.org before
>> so that the history is complete...)
> The output is attached. I'm not sure if we can include the result in
> auctex.texi without further massaging.
I tried. It seems that it can't just be included in auctex.texi. The
result is many warnings quoted below and no info file is generated:
NEWS.texi:3: warning: @setfilename after the first element
NEWS.texi:4: warning: multiple @settitle
NEWS.texi:9: warning: @dircategory after first node
NEWS.texi:10: warning: @direntry after first node
NEWS.texi:15: warning: multiple @titlepage
NEWS.texi:16: warning: multiple @title
NEWS.texi:22: warning: multiple @top
NEWS.texi:21: @node `Top' previously defined
auctex.texi:57: here is the previous definition as @node
auctex.texi:131: @menu reference to nonexistent node `Indices'
auctex.texi:6129: @menu reference to nonexistent node `Development'
auctex.texi:6130: @menu reference to nonexistent node `FAQ'
auctex.texi:6131: @menu reference to nonexistent node `Texinfo mode'
auctex.texi:230: @detailmenu reference to nonexistent node `Development'
auctex.texi:231: @detailmenu reference to nonexistent node `FAQ'
auctex.texi:232: @detailmenu reference to nonexistent node `Texinfo mode'
auctex.texi:240: @detailmenu reference to nonexistent node `Key Index'
auctex.texi:241: @detailmenu reference to nonexistent node `Function Index'
auctex.texi:242: @detailmenu reference to nonexistent node `Variable Index'
auctex.texi:243: @detailmenu reference to nonexistent node `Concept Index'
NEWS.texi:21: warning: node `Top' lacks menu item for `[Unreleased]' despite
being its Up target
NEWS.texi:21: warning: node `Top' lacks menu item for `[1406] - 2024-06-30'
despite being its Up target
NEWS.texi:21: warning: node `Top' lacks menu item for `[1405] - 2024-05-19'
despite being its Up target
NEWS.texi:21: warning: node `Top' lacks menu item for `[1404] - 2024-03-31'
despite being its Up target
NEWS.texi:21: warning: node `Top' lacks menu item for `[1403] - 2024-02-20'
despite being its Up target
NEWS.texi:21: warning: node `Top' lacks menu item for `[1402] - 2024-02-09'
despite being its Up target
NEWS.texi:21: warning: node `Top' lacks menu item for `[1401] - 2024-02-08'
despite being its Up target
What I did was to replace
@include changes.texi
in auctex.texi with
@include NEWS.texi
and to run "makeinfo auctex.texi".
>> (It would be even better when we somehow add the entries from
>> changes.texi in NEWS.org before so that the history is complete...)
I think we don't have to care completeness much. Much older change logs
are recorded only in history.texi and appears nowhere in the current
AUCTeX manual. (It just says
See the file @file{history.texi} for older changes.
in auctex.texi.)
So I basically agree with Arash's proposal:
> This will probably turn into "Read NEWS.org".
(However, this has one possible drawback; users who want to upgrade
can't see what's new on
https://elpa.gnu.org/packages/doc/auctex.html
in advance.)
Regards,
Ikumi Keita
#StandWithUkraine #StopWarInUkraine
#Gaza #StopMassiveKilling #CeasefireNOW
0001-temporal-commit.patch.gz
Description: WIP patch
