From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Glenn Morris Newsgroups: gmane.emacs.devel Subject: Re: procedure for creating online Emacs manual? Date: Fri, 30 Mar 2018 20:58:07 -0400 Message-ID: References: <132c3a65-ac0a-49de-d9cd-1812aef336ae@cs.ucla.edu> <112b96b9-ec4d-d5b2-b813-999d7004becc@cs.ucla.edu> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: blaine.gmane.org 1522457812 14673 195.159.176.226 (31 Mar 2018 00:56:52 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 31 Mar 2018 00:56:52 +0000 (UTC) User-Agent: Gnus (www.gnus.org), GNU Emacs (www.gnu.org/software/emacs/) Cc: Emacs development discussions To: Paul Eggert Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Mar 31 02:56:48 2018 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1f24p6-0003jj-30 for ged-emacs-devel@m.gmane.org; Sat, 31 Mar 2018 02:56:48 +0200 Original-Received: from localhost ([::1]:58047 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f24r9-00040i-HX for ged-emacs-devel@m.gmane.org; Fri, 30 Mar 2018 20:58:55 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:40235) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f24qR-00040I-Ob for emacs-devel@gnu.org; Fri, 30 Mar 2018 20:58:12 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1f24qQ-0005Id-Sp for emacs-devel@gnu.org; Fri, 30 Mar 2018 20:58:11 -0400 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:37570) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1f24qO-0005GG-5T; Fri, 30 Mar 2018 20:58:08 -0400 Original-Received: from rgm by fencepost.gnu.org with local (Exim 4.82) (envelope-from ) id 1f24qN-0005EA-Jl; Fri, 30 Mar 2018 20:58:07 -0400 X-Spook: Gulf Cartel NORAD Exon Shell Eco terrorism Sleet Crypto X-Ran: :|`b|um^N~X0~k!]|UDzoJ>`WiR:\u_BOB:Ld\r*y!k9Q}n|h`/%@3q};-NH-'Q[c7[Qu` X-Hue: red X-Attribution: GM X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:224192 Archived-At: Paul Eggert wrote: > 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. Anyone should free to fix it, it's not difficult IMO. > 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) Yes we do? https://www.gnu.org/software/emacs/refcards/index.html > by installing the attached into 'master', and left in a FIXME for the > stuff I couldn't figure out. Re this: > FIXME: The above instructions are not quite complete, as they do not > specify how to copy the generated files in the 'manual' directory to > the corresponding web files. Not scripted, copy by hand. Might be good to script. Need to cvs remove any pages that are no longer present, cvs add new ones, etc. > Also, they are missing some files, e.g., they generate > manual/html_mono/ada-mode.html but do not generate the top-level > ada-mode.html file for the one-node-per-page version. If you mean eg https://www.gnu.org/software/emacs/manual/ada-mode.html then you never need to change that page. If a new texinfo manual is added, just copy an existing index page and change by hand as needed. > I couldn't build the refcards on Fedora 27, due to some problem with > larm1000 (see below). It used to work for me on Debian, once I installed the relevant TeX language packages, but I haven't tried in a while.