Hi Keita,
Ikumi Keita <ik...@ikumi.que.jp> writes:
> Then I suppose we can just discard these rules and should revise the
> document. I attach a WIP patch.
Thanks for starting this. I had a brief look, at LGTM. Do you want to
install it on main or on a temp branch? I think we have to optimize it
here and there, but overall it looks good. One thing I'd like to get
into the manual is snippets for using AUCTeX with `use-package', e.g.,
(use-package auctex
:init
(load "~/development/auctex/auctex-autoloads.el" nil t t)
(with-eval-after-load 'info
(add-to-list 'Info-additional-directory-list
"~/development/auctex/doc")))
in the section for loading out of a local repo.
> 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?
I think we can do that.
> 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:
It seems to me that `org-texinfo-export-to-texinfo-batch' generates
stand-alone .texi files and not ones intended to be included somewhere
else.
> 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".
Thanks :-)
> (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.)
Hmm, actually the exercise with NEWS.org began in order to get something
in the NEWS section on the ELPA page:
https://elpa.gnu.org/packages/auctex.html
I hope the changes are placed more prominently now. But yes, they will
be missing in the manual.
Best, Arash
