[3/3] binutils: update release docs process

Message ID 20210502170743.6488-3-vapier@gentoo.org
State New
Headers show
Series
  • [1/3] generate single html manual page by default
Related show

Commit Message

Claudiu Zissulescu via Binutils May 2, 2021, 5:07 p.m.
Now that we generate multiple html & pdf forms, update the release
process to show how they get updated.
---
 binutils/README-how-to-make-a-release | 38 ++++++++++++++++-----------
 1 file changed, 22 insertions(+), 16 deletions(-)

-- 
2.31.1

Comments

Claudiu Zissulescu via Binutils May 7, 2021, 12:40 p.m. | #1
Hi Mike,

> Now that we generate multiple html & pdf forms, update the release

> process to show how they get updated.


Patch approved  - please apply.

Cheers
   Nick

Patch

diff --git a/binutils/README-how-to-make-a-release b/binutils/README-how-to-make-a-release
index ea8a5a10318f..9e704b20e2e3 100644
--- a/binutils/README-how-to-make-a-release
+++ b/binutils/README-how-to-make-a-release
@@ -247,7 +247,7 @@  When the time comes to actually make the release....
         make install-gas install-gold install-ld install-binutils
 
         # Needed for step 29...
-        make html
+        make html pdf
 
   26. Tag the branch with the new release number:
 
@@ -296,11 +296,7 @@  When the time comes to actually make the release....
          cd /sourceware/www/sourceware/htdocs/binutils
 	 mkdir docs-2.3x
 	 cd docs-2.3x
-	 mkdir as
-	 mkdir bfd
-	 mkdir binutils
-	 mkdir gprof
-	 mkdir ld
+	 mkdir as bfd binutils gprof ld
 	 cd ../docs-2.3(x-1)
 	 get index.html
 
@@ -316,20 +312,30 @@  When the time comes to actually make the release....
       however, so the directories had to be made by hand, as shown above).
 
          cd as
-	 lcd <build-dir>/gas/doc/as.html
-	 put *      {be patient - this takes a long time...}
+	 lcd <build-dir>/gas/doc/
+	 put -R as                {be patient - this takes a long time...}
+	 put as.html
+	 put as.pdf
 	 cd ../bfd
-	 lcd ../../../bfd/doc/bfd.html
-	 put *
+	 lcd ../../../bfd/doc/
+	 put -R bfd
+	 put bfd.html
+	 put bfd.pdf
 	 cd ../binutils
-	 lcd ../../../binutils/doc/binutils.html
-	 put *
+	 lcd ../../../binutils/doc/
+	 put -R binutils
+	 put binutils.html
+	 put binutils.pdf
 	 cd ../gprof
-	 lcd ../../../gprof/gprof.html
-	 put *
+	 lcd ../../../gprof/
+	 put -R doc/gprof
+	 put gprof.html
+	 put gprof.pdf
 	 cd ../ld
-	 lcd ../../ld/ld.html
-	 put *
+	 lcd ../../ld/
+	 put -R doc/ld
+	 put ld.html
+	 put ld.pdf
 	 
       Edit the top level binutils index.html file to change the links
       to point to the new documentation.