Patchwork Version specific onlinedocs page

login
register
mail settings
Submitter Tobias Burnus
Date Feb. 18, 2013, 7:54 a.m.
Message ID <5121DE22.2010108@net-b.de>
Download mbox | patch
Permalink /patch/221149/
State New
Headers show

Comments

Tobias Burnus - Feb. 18, 2013, 7:54 a.m.
Gerald Pfeifer wrote:
> On Sun, 17 Feb 2013, Tobias Burnus wrote:
>> I wonder if we could generate a version-specific page for the online
>> documentation. I think that should be trivial to maintain and I know
>> at least one vendor who would use it.
>
> If "we" means that you are volunteering ;-), absolutely, go for it!

;-)


How about the following patch? If it is okay, I will add the remaining 
index.html for 4.6 and 4.7 and update gcc-4.6/index.html – and then 
commit it. (I don't see a need to update versions before 4.6.)

Tobias
Gerald Pfeifer - Feb. 20, 2013, 2:15 a.m.
On Mon, 18 Feb 2013, Tobias Burnus wrote:
>> If "we" means that you are volunteering ;-), absolutely, go for it!
> ;-)
> 
> 
> How about the following patch? If it is okay, I will add the remaining 
> index.html for 4.6 and 4.7 and update gcc-4.6/index.html – and then 
> commit it.

Looks good to me.

Perhaps you can add a note for the release manager how to "create"
index.html (copy from previous release and adjust)?

Gerald

Patch

Index: htdocs/gcc-4.7/index.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/gcc-4.7/index.html,v
retrieving revision 1.4
diff -u -p -r1.4 index.html
--- htdocs/gcc-4.7/index.html	20 Sep 2012 06:31:19 -0000	1.4
+++ htdocs/gcc-4.7/index.html	18 Feb 2013 07:49:34 -0000
@@ -22,17 +22,20 @@  in GCC 4.7.1 relative to previous releas
 
 <dt>GCC 4.7.2</dt>
 <dd><a name="4.7.2">September 20, 2012</a>
-    (<a href="changes.html">changes</a>)
+    (<a href="changes.html">changes</a>,
+     <a href="http://www.gnu.org/onlinedocs/4.7.2/">documentation</a>)
 </dd>
 
 <dt>GCC 4.7.1</dt>
 <dd><a name="4.7.1">June 14, 2012</a>
-    (<a href="changes.html">changes</a>)
+    (<a href="changes.html">changes</a>,
+     <a href="http://www.gnu.org/onlinedocs/4.7.1/">documentation</a>)
 </dd>
 
 <dt>GCC 4.7.0</dt>
 <dd><a name="4.7.0">March 22, 2012</a>
-    (<a href="changes.html">changes</a>)
+    (<a href="changes.html">changes</a>,
+     <a href="http://www.gnu.org/onlinedocs/4.7.0/">documentation</a>)
 </dd>
 
 </dl>
Index: htdocs/releasing.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/releasing.html,v
retrieving revision 1.39
diff -u -p -r1.39 releasing.html
--- htdocs/releasing.html	23 Mar 2012 08:44:11 -0000	1.39
+++ htdocs/releasing.html	18 Feb 2013 07:49:34 -0000
@@ -75,7 +75,9 @@  to generate the documentation would be <
 -rgcc_3_0_2_release -dgcc-3.0.2</code> (with the current version
 number inserted).  Link to it from <code>onlinedocs/index.html</code>
 (but don't break URLs to documentation for previous releases even if
-you remove the links to it).</li>
+you remove the links to it).  Create additionally
+<code>onlinedocs/<em>version-number</em>/index.html</code> to link
+to the documentation.</li>
 
 <li>Update the online-documentation links in <code>changes.html</code>
 to point to the online-documentation for the branch.</li>
--- /dev/null	2013-02-18 07:34:01.727808559 +0100
+++ htdocs/onlinedocs/4.7.2/index.html	2013-02-18 08:47:51.000000000 +0100
@@ -0,0 +1,90 @@ 
+<html>
+
+<head>
+<title>GCC 4.7.2 manuals</title>
+</head>
+
+<body>
+
+<h1>4.7.2 manuals</h1>
+  <ul>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gcc/">GCC
+         4.7.2 Manual</a> (<a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gcc.pdf">also
+         in PDF</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gcc.ps.gz">PostScript</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gcc-html.tar.gz">an
+         HTML tarball</a>)</li>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gfortran/">GCC
+         4.7.2 GNU Fortran Manual</a> (<a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gfortran.pdf">also
+         in PDF</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gfortran.ps.gz">PostScript</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gfortran-html.tar.gz">an
+         HTML tarball</a>)</li>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gcj/">GCC
+         4.7.2 GCJ Manual</a> (<a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gcj.pdf">also
+         in PDF</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gcj.ps.gz">PostScript</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gcj-html.tar.gz">an
+         HTML tarball</a>)</li>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/cpp/">GCC 
+         4.7.2 CPP Manual</a> (<a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/cpp.pdf">also
+         in PDF</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/cpp.ps.gz">PostScript</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/cpp-html.tar.gz">an
+         HTML tarball</a>)</li>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gnat_rm/">GCC
+         4.7.2 GNAT Reference Manual</a> (<a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gnat_rm.pdf">also
+         in PDF</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gnat_rm.ps.gz">PostScript</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gnat_rm-html.tar.gz">an
+         HTML tarball</a>)</li>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gnat_ugn_unw/">GCC
+         4.7.2 GNAT User's Guide</a> (<a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gnat_ugn_unw.pdf">also
+         in PDF</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gnat_ugn_unw.ps.gz">PostScript</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gnat_ugn_unw-html.tar.gz">an
+         HTML tarball</a>)</li>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libstdc++/manual/">GCC
+         4.7.2 Standard C++ Library Manual </a> (<a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libstdc++/libstdc++-manual.pdf.bz2">also
+         in PDF</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libstdc++/libstdc++-manual.xml.bz2">XML</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libstdc++/libstdc++-manual-html.tar.bz2">an
+         HTML tarball</a>)</li>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libstdc++/api/">GCC
+         4.7.2 Standard C++ Library Reference Manual </a> (<a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libstdc++/libstdc++-api.pdf.bz2">also
+         in PDF</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libstdc++/libstdc++-api.xml.bz2">XML</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libstdc++/libstdc++-api-html.tar.bz2">an
+         HTML tarball</a>)</li>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gccgo/">GCCGO 4.7.2 Manual</a> (<a
+           href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gccgo.pdf">also in
+           PDF</a> or <a
+           href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gccgo.ps.gz">PostScript</a> or <a
+           href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/gccgo-html.tar.gz">an
+           HTML tarball</a>)</li>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libgomp/">GCC 4.7.2
+         GNU OpenMP Manual</a> (<a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libgomp.pdf">also in
+         PDF</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libgomp.ps.gz">PostScript</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libgomp-html.tar.gz">an
+         HTML tarball</a>)</li>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libquadmath/">GCC 4.7.2
+         Quad-Precision Math Library Manual</a> (<a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libquadmath.pdf">also in
+         PDF</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libquadmath.ps.gz">PostScript</a> or <a
+         href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/libquadmath-html.tar.gz">an
+         HTML tarball</a>)</li>
+    <li><a href="http://gcc.gnu.org/onlinedocs/gcc-4.7.2/docs-sources.tar.gz">Texinfo
+         sources of all the GCC 4.7.2 manuals</a></li>
+  </ul></body>
+</html>