[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: procedure for creating online Emacs manual?
From: |
Paul Eggert |
Subject: |
Re: procedure for creating online Emacs manual? |
Date: |
Fri, 30 Mar 2018 16:23:37 -0700 |
User-agent: |
Mozilla/5.0 (X11; Linux x86_64; rv:52.0) Gecko/20100101 Thunderbird/52.6.0 |
On 03/30/2018 12:32 PM, Glenn Morris wrote:
I don't think there were any (?) changes to the manual between 25.2
and the latest release (ie 25.3).
OK. It is confusing that the latest release is 25.3 but the online
manuals say 25.2, but we can live with it if it's too much trouble to fix.
What's the procedure for generating the online manual from the
released version?
It is summarized at the end of admin/make-tarball.txt.
Basically it uses M-x make-manuals from admin/admin.el.
Thanks. I tried to follow that procedure but came up dry. I fixed the
problems that I found (e.g., we don't put refcards up on the web any
more) by installing the attached into 'master', and left in a FIXME for
the stuff I couldn't figure out. Plus, I altered the instructions so
that the tarballs are reproducible. (It wouldn't hurt to go reproducible
even for Emacs 26 but I was leery of changing distribution instructions
in the emacs-26 branch.)
I couldn't build the refcards on Fedora 27, due to some problem with
larm1000 (see below). Maybe we should stop maintaining the refcards
since we no longer put them on the web? I doubt whether they're used
much any more and the whole idea of a refcard is so 1980s anyway. Stefan
hinted at doing that here:
https://lists.gnu.org/archive/html/emacs-devel/2016-11/msg00715.html
Here's the failed refcard build on Fedora:
$ make -C etc/refcards pdf ps
...
pdflatex ru-refcard.tex
This is pdfTeX, Version 3.14159265-2.6-1.40.17 (TeX Live 2016)
(preloaded format=pdflatex)
 restricted \write18 enabled.
entering extended mode
(./ru-refcard.tex
LaTeX2e <2016/03/31>
Babel <3.9r> and hyphenation patterns for 22 language(s) loaded.
(/usr/share/texlive/texmf-dist/tex/latex/base/article.cls
Document Class: article 2014/09/29 v1.4h Standard LaTeX document class
...
kpathsea: Running mktextfm larm1000
/usr/share/texlive/texmf-dist/web2c/mktexnam: Could not map source
abbreviation for larm1000.
/usr/share/texlive/texmf-dist/web2c/mktexnam: Need to update ?
mktextfm: Running mf-nowin -progname=mf \mode:=ljfour; mag:=1;
nonstopmode; input larm1000
This is METAFONT, Version 2.7182818 (TeX Live 2016) (preloaded base=mf)
kpathsea: Running mktexmf larm1000
! I can't find file `larm1000'.
<*> ...ljfour; mag:=1; nonstopmode; input larm1000
...
Transcript written on ru-refcard.log.
make: *** [Makefile:262: ru-refcard.pdf] Error 1
0001-Improve-doc-for-web-pages-reproducible-tarballs.patch
Description: Text Data