From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Stephen J. Turnbull" Newsgroups: gmane.emacs.devel Subject: Re: Cannot generate web manuals Date: Mon, 30 Dec 2013 12:47:20 +0900 Message-ID: <874n5rknjr.fsf@uwakimon.sk.tsukuba.ac.jp> References: NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 X-Trace: ger.gmane.org 1388375384 19576 80.91.229.3 (30 Dec 2013 03:49:44 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 30 Dec 2013 03:49:44 +0000 (UTC) Cc: Xue Fuqiao , emacs-devel To: Glenn Morris Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Dec 30 04:49:52 2013 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1VxTrT-00080D-T9 for ged-emacs-devel@m.gmane.org; Mon, 30 Dec 2013 04:49:52 +0100 Original-Received: from localhost ([::1]:56965 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VxTrT-0001pV-H4 for ged-emacs-devel@m.gmane.org; Sun, 29 Dec 2013 22:49:51 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35058) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VxTrK-0001pD-KD for emacs-devel@gnu.org; Sun, 29 Dec 2013 22:49:48 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1VxTrB-0003kO-Ie for emacs-devel@gnu.org; Sun, 29 Dec 2013 22:49:42 -0500 Original-Received: from mgmt2.sk.tsukuba.ac.jp ([130.158.97.224]:38387) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1VxTrB-0003Wz-7b for emacs-devel@gnu.org; Sun, 29 Dec 2013 22:49:33 -0500 Original-Received: from uwakimon.sk.tsukuba.ac.jp (uwakimon.sk.tsukuba.ac.jp [130.158.99.156]) by mgmt2.sk.tsukuba.ac.jp (Postfix) with ESMTP id 5A49F9708E0; Mon, 30 Dec 2013 12:47:20 +0900 (JST) Original-Received: by uwakimon.sk.tsukuba.ac.jp (Postfix, from userid 1000) id 4E6601A26F6; Mon, 30 Dec 2013 12:47:20 +0900 (JST) In-Reply-To: X-Mailer: VM undefined under 21.5 (beta34) "kale" 2a0f42961ed4 XEmacs Lucid (x86_64-unknown-linux) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 130.158.97.224 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:166982 Archived-At: Glenn Morris writes: > Xue Fuqiao wrote: > > >> I would not bother if I were you. To date we intentionally only provide > >> the main manuals in non-html formats. It is a pain to keep multiple > >> formats up-to-date, for little benefit IMO. > > > > Why? Can't we just use the same method used by emacs/lispref/eintr for > > `(manual-misc-manuals)' and just press `M-x make-manuals'? > > Of course you _can_ do that, I'm saying it's pointless. Considering the existence of readthedocs.org, yep, it's pointless. Of course, RTDO doesn't support Texinfo, which might be a problem. But wait! The RTDO site is free software (MIT license, so GPL-able if you wish) and requires only free software (Python and Django) to run. You already have the code for making docs (in the Makefiles), which is undoubtedly (haven't actually checked, but...) the smallest part of the site anyway. > Does any distribution package the pdf versions of those files? Not that I know of, but readthedocs.org does. > Is there anyone who really wants the pdf version and does not have > access to TeX? Windows users, Mac users, tablet users. (Being able to install via Cygwin or MacPorts or from source is not "having access", and AFAIK TeX hasn't been ported to iOS -- tell me I'm wrong, Mitsuharu! -- or Android.) > I guarantee you that if you only do some, someone will complain about > the ones you did not do. So you'll have to do them all. And update all > formats, at every release. Mechanical process, should not require human intervention. readthedocs.gnu.org, anybody? (Not me, I'm fine with Info -- I only read Emacs docs when in Emacs anyway.) Steve