[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[6990] README-hacking release instructions
From: |
Gavin D. Smith |
Subject: |
[6990] README-hacking release instructions |
Date: |
Sat, 06 Feb 2016 10:53:13 +0000 |
Revision: 6990
http://svn.sv.gnu.org/viewvc/?view=rev&root=texinfo&revision=6990
Author: gavin
Date: 2016-02-06 10:53:11 +0000 (Sat, 06 Feb 2016)
Log Message:
-----------
README-hacking release instructions
Modified Paths:
--------------
trunk/ChangeLog
trunk/README-hacking
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2016-02-06 10:38:22 UTC (rev 6989)
+++ trunk/ChangeLog 2016-02-06 10:53:11 UTC (rev 6990)
@@ -1,5 +1,16 @@
2016-02-06 Gavin Smith <address@hidden>
+ * README-hacking: Update notes about making a release. Move
+ "make po-check" line. Remove "rm ti.texi" for updating texindex
+ version. Move gnulib-tool --add-import and util/srclist-txi,
+ and say what the latter is for. Move "official releases only"
+ section only so that the "make distcheck" line above can be the
+ final command to produce the release tarball. Move upload
+ instructions after this command. Move instructions about
+ tagging source tree. Combine instructions about checking DTD.
+
+2016-02-06 Gavin Smith <address@hidden>
+
* doc/texinfo-tex-test.texi,
* doc/Makefile.am,
* doc/info-stnd.texi,
Modified: trunk/README-hacking
===================================================================
--- trunk/README-hacking 2016-02-06 10:38:22 UTC (rev 6989)
+++ trunk/README-hacking 2016-02-06 10:53:11 UTC (rev 6990)
@@ -153,44 +153,57 @@
Ensure TXI_XLATE in doc/Makefile.am matches actual file list.
Check that TEXINFO_DTD_VERSION has been updated to the next version in
configure.ac if the DTD has been modified since the last release.
+ See comments in configure.ac, and run (at the top level) make dtd-check.
Check "make ccheck" and "make vcheck" work in "doc/refcard".
Check "dist-xz" is in the option list in configure.ac (often removed
for speed when testing).
+make po-check # update po/POTFILES.in as needed
+gnulib-tool --add-import # for pretest
+util/srclist-txi # for pretest, to sync files with other sources
+- Official releases only:
+version number in texi2dvi, texi2pdf, txirefcard.tex.
+version and date in NEWS.
+(cd tp && ./maintain/change_perl_modules_version.sh auto)
+ -- this updates all the version numbers in the Perl modules
+sync texi2html/test/ results with tp/.
+
+ensure building standalone modules for CPAN still works.
+make V=1 pdf and fix underfull/overfull boxes.
+
- Changes to sources:
update version in configure.ac, notice in ChangeLog.
check that texindex version is updated properly
- (rm ti.texi texindex.awk ; make)
-gnulib-tool --add-import # for pretest
+ (rm texindex.awk ; make)
Check that translations have been updated, e.g.:
rsync -Lrtzv translationproject.org::tp/latest/texinfo/ texinfo
rsync -Lrtzv translationproject.org::tp/latest/texinfo_document/ \
texinfo_document
-followed by copying updated translation files to po/ and po_document/.
-util/srclist-txi # for pretest
+ followed by copying updated translation files to po/ and po_document/.
pod2man Pod-Simple-Texinfo/pod2texi.pl >man/pod2texi.1 # until we fix deps
make
-make po-check # update po/POTFILES.in as needed
make update-po # both po and po_document needed, build a dist first
make -C doc wwwdoc-build # and -install for official (and eventual commit)
make long-checks # distcheck does not do this
(export MALLOC_CHECK_=2; make distcheck) # repeat until clean
svn commit # when clean, then distcheck to be sure
-- Official releases only:
-version number in texi2dvi, texi2pdf, txirefcard.tex.
-version and date in NEWS.
-(cd tp && ./maintain/change_perl_modules_version.sh auto)
- -- this updates all the version numbers in the Perl modules
-sync texi2html/test/ results with tp/.
+- To do the actual upload:
+pkg=texinfo
+ver=6.0
-ensure building standalone modules for CPAN still works.
-make V=1 pdf and fix underfull/overfull boxes.
+then do one of:
+gnupload --to alpha.gnu.org:$pkg $pkg-$ver.tar.xz #pretest
+gnupload --to ftp.gnu.org:$pkg $pkg-$ver.tar.{gz,xz} *.diff.xz #official
+ Use --user option if not using default key
+ texinfo.tex and texi2dvi should already be up to date, but check. Use
+gnupload --replace --to ftp.gnu.org:texinfo texi2dvi
-# ... dtd version check:
-TEXINFO_DTD_VERSION should already have been updated to $ver in
-configure.ac if it was needed, but check again. See comments in
-configure.ac, and run (at the top level) make dtd-check.
+# Official releases only: tag source tree (use your own username before @):
+svn copy -r 6363 -m'texinfo_6_0 tag based on r6363' \
+ svn+ssh://address@hidden/texinfo/trunk \
+ svn+ssh://address@hidden/texinfo/tags/texinfo_6_0
+[for karl: /srv/svn/texinfo]
# ... set up dtd directory on web pages:
cd $HOME/gnu/www/texinfo/dtd # or wherever webpages checkout is
@@ -217,18 +230,10 @@
rm -rf texinfo-$ver texinfo-$prev
ro texinfo-*$ver*
-- To do the actual upload:
+- To save in local archives:
pkg=texinfo
ver=6.0
-then do one of:
-gnupload --to alpha.gnu.org:$pkg $pkg-$ver.tar.xz #pretest
-gnupload --to ftp.gnu.org:$pkg $pkg-$ver.tar.{gz,xz} *.diff.xz #official
- Use --user option if not using default key
- texinfo.tex and texi2dvi should already be up to date, but check. Use
-gnupload --replace --to ftp.gnu.org:texinfo texi2dvi
-
-and the corresponding, to save in local archives:
mv -v $pkg-$ver.tar.xz* $misc/archive/$pkg/alpha/ #pretest
mv -v $pkg-$ver.tar.{gz,xz}* *.diff.xz $misc/archive/$pkg/prod/ #official
@@ -244,12 +249,6 @@
followed by cvs rm -f. Likewise, check for added files with
cvs -qn update, followed by cvs add. When done, run cvs commit.
-# Official releases only: tag source tree (use your own username before @):
-svn copy -r 6363 -m'texinfo_6_0 tag based on r6363' \
- svn+ssh://address@hidden/texinfo/trunk \
- svn+ssh://address@hidden/texinfo/tags/texinfo_6_0
-[for karl: /srv/svn/texinfo]
-
# Official releases only: ... update texinfo at tug.org
# (contact address@hidden):
prev=5.2
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [6990] README-hacking release instructions,
Gavin D. Smith <=