From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Jim Meyering Newsgroups: gmane.emacs.devel Subject: updating web manuals [Re: Emacs 23.3 released Date: Sat, 12 Mar 2011 10:28:48 +0100 Message-ID: <87oc5gbsbz.fsf_-_@rho.meyering.net> References: <87hbbahkgm.fsf@stupidchicken.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: dough.gmane.org 1299922143 24089 80.91.229.12 (12 Mar 2011 09:29:03 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Sat, 12 Mar 2011 09:29:03 +0000 (UTC) Cc: emacs-devel@gnu.org To: Chong Yidong Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Mar 12 10:28:59 2011 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PyL87-0002L1-7J for ged-emacs-devel@m.gmane.org; Sat, 12 Mar 2011 10:28:59 +0100 Original-Received: from localhost ([127.0.0.1]:49657 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PyL85-00062u-Vg for ged-emacs-devel@m.gmane.org; Sat, 12 Mar 2011 04:28:58 -0500 Original-Received: from [140.186.70.92] (port=45839 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1PyL81-00061r-Am for emacs-devel@gnu.org; Sat, 12 Mar 2011 04:28:54 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1PyL7z-0006Kt-0G for emacs-devel@gnu.org; Sat, 12 Mar 2011 04:28:52 -0500 Original-Received: from mx.meyering.net ([82.230.74.64]:60880) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1PyL7y-0006Ko-R9 for emacs-devel@gnu.org; Sat, 12 Mar 2011 04:28:50 -0500 Original-Received: by rho.meyering.net (Acme Bit-Twister, from userid 1000) id 5EC73600DA; Sat, 12 Mar 2011 10:28:48 +0100 (CET) In-Reply-To: <87hbbahkgm.fsf@stupidchicken.com> (Chong Yidong's message of "Thu, 10 Mar 2011 13:57:45 -0500") Original-Lines: 26 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6 (newer, 3) X-Received-From: 82.230.74.64 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:137144 Archived-At: Chong Yidong wrote: > Note, by the way, that the manuals on the webpage are not yet updated > yet. I will do that over the next few days. That can be a tediously er,... manual task, so for packages like coreutils, diffutils, grep, etc., I automated it with this script: http://git.sv.gnu.org/cgit/gnulib.git/tree/build-aux/gnu-web-doc-update Now, I run "build-aux/gnu-web-doc-update" after each release, and it does everything. Slightly hard to see is that it uses the web-manual rule from gnulib's maint.mk: .PHONY: web-manual web-manual: @test -z "$(manual_title)" \ && { echo define manual_title in cfg.mk 1>&2; exit 1; } || : @cd '$(srcdir)/doc'; \ $(SHELL) ../build-aux/gendocs.sh $(gendocs_options_) \ -o '$(abs_builddir)/doc/manual' \ --email $(PACKAGE_BUGREPORT) $(PACKAGE) \ "$(PACKAGE_NAME) - $(manual_title)" @echo " *** Upload the doc/manual directory to web-cvs." It is obviously tailored to the use of git and other aspects of those projects, but may be useful if you want to do something similar for emacs.