From: "Stephen J. Turnbull" <stephen@xemacs.org>
To: Glenn Morris <rgm@gnu.org>
Cc: Xue Fuqiao <xfq.free@gmail.com>, emacs-devel <emacs-devel@gnu.org>
Subject: Re: Cannot generate web manuals
Date: Mon, 30 Dec 2013 12:47:20 +0900 [thread overview]
Message-ID: <874n5rknjr.fsf@uwakimon.sk.tsukuba.ac.jp> (raw)
In-Reply-To: <vqha9rrux0.fsf@fencepost.gnu.org>
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
next prev parent reply other threads:[~2013-12-30 3:47 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2013-12-29 4:04 Cannot generate web manuals Xue Fuqiao
2013-12-29 5:53 ` Thien-Thi Nguyen
2013-12-29 15:43 ` Eli Zaretskii
2013-12-29 20:13 ` Glenn Morris
2013-12-29 23:32 ` Xue Fuqiao
2013-12-30 1:26 ` Glenn Morris
2013-12-30 3:47 ` Stephen J. Turnbull [this message]
2013-12-30 14:28 ` Xue Fuqiao
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=874n5rknjr.fsf@uwakimon.sk.tsukuba.ac.jp \
--to=stephen@xemacs.org \
--cc=emacs-devel@gnu.org \
--cc=rgm@gnu.org \
--cc=xfq.free@gmail.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.