Commits

Anonymous committed ff6b9aa

[xemacsweb PATCH] Cosmetic and indentation changes to About/Website.content <u4s3fdju9.fsf@ecf.teradyne.com>

  • Participants
  • Parent commits f4d7ff6

Comments (0)

Files changed (2)

File About/ChangeLog

+2000-09-17  Adrian Aichner  <aichner@ecf.teradyne.com>
+
+	* Website.content: Cosmetic and indentation changes.
+
 2000-09-13  Adrian Aichner  <aichner@ecf.teradyne.com>
 
 	* Website.content: Minor improvements.

File About/Website.content

               Here is a list of key features the new site
               provides:</p>
             <ul>
-              <li><p>All site content is under CVS control</p></li>
+              <li><p>All site content is under CVS control.</p></li>
               <li><p>CVS commits update the website
-                  automatically</p></li>
+                  automatically.</p></li>
+              <li><p>The XEmacs website is just another CVS working
+                  directory containing the latest revisions of files from
+                  the repository.  Consequently all its ChangeLog files,
+                  .cvsignore files, genpage .content files, perl scripts,
+                  emacs-lisp files are also available via the
+                  website.</p></li>
               <li><p>HTML document changes are validated against their
-                  DTD automatically</p></li>
+                  DTD automatically.</p></li>
               <li><p><a href="../genpage/www/index.html">genpage</a>
                   eases maintenance of a consistent look</p></li>
               <li><p>All intra-site links are relative to allow site
                   mirroring and link-testing in developers working
-                  directories</p></li>
+                  directories.</p></li>
               <li><p>Website development model is fully in line with
-                  XEmacs development model</p></li>
+                  XEmacs development model.</p></li>
               <li><p>Site update <a href="../logs/">logs</a> are
-                  available via HTTP</p></li>
+                  available via HTTP.</p></li>
             </ul>
             <hr>
             <h2>XEmacs <a name="XWCR">Website</a> CVS Repository</h2>
 specified genpage template.  It is equivalent to the contents of the
 &lt;body&gt;...&lt;/body&gt; section of a corresponding HTML
 document.</pre>
-		  </td>
-		</tr>
-	      </tbody>
-	    </table>
-	    <p>When you need to avoid substitution of <a href="../genpage/www/index.html#7">genpage content
-		tags</a> in .content files (like I did in the table
-	      above) you may use following trick:</p>
-	    <pre>
+                  </td>
+                </tr>
+              </tbody>
+            </table>
+            <p>When you need to avoid substitution of <a href="../genpage/www/index.html#7">genpage content
+                tags</a> in .content files (like I did in the table
+              above) you may use following trick:</p>
+            <pre>
 &lt;!-- _GP_ qq{%title%} --&gt;
-	    </pre>
-	    <p>
-	      Above genpage command returns the string-quoted
-	      genpage content tag as a string.</p>
-	    <h3><a name="Gcffehd">Generate</a> .content files from existing .html documents</h3>
-	    <p><a href="#index">Goto</a> Index</p>
-	    <p>Use <a href="http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/xemacsweb/html2content.pl?cvsroot=xemacs">xemacsweb/html2content.pl</a>
-	      to convert all .html files in a specified directory
-	      (recursively) to .content files.  Existing .content
-	      files will not be overwritten.</p>
-	    <h3>Edit .html <a name="Ehfambtcf">file</a> and merge back to .content file</h3>
-	    <p><a href="#index">Goto</a> Index</p>
-	    <p>This gives you the power of your favorite HTML
-	      editor (you are not using notepad, are you?) and
-	      changes can easily be merged to the .content file with
-	      <cite>ediff</cite>.</p>
-	    <h3>Use <a name="Ul-cHt">lower</a>-case HTML tags</h3>
-	    <p><a href="#index">Goto</a> Index</p>
-	    <p>This is in preparation of a possible future
-	      migration to <cite>XML</cite>.</p>
-	    <h3>Use relative links <a name="Urlwp">wherever</a> possible</h3>
-	    <p><a href="#index">Goto</a> Index</p>
-	    <p>This makes site mirroring a free gift and allows
-	      developers to test intra-site links in their private
-	      working directories off-site.</p>
-	    <h3>Use logical vs. physical <a name="Ulvpm">markup</a></h3>
-	    <p><a href="#index">Goto</a> Index</p>
-	    <p>It is a HTML authoring commandment to prefer logical
-	      markups like &lt;blockquote&gt;</p>
-	    <blockquote>
-	      blockquote</blockquote>&lt;/blockquote&gt;,
-	    &lt;strong&gt;<strong>strong</strong>&lt;/strong&gt;,
-	    &lt;cite&gt;<cite>cite</cite>&lt;/cite&gt;,
-	    &lt;samp&gt;<samp>samp</samp>&lt;/samp&gt; over
-	    physical markup like &lt;br&gt;<br> linebreak<br>
-	    &lt;br&gt;, &lt;b&gt;<b>bold</b>&lt;/b&gt;,
-	    &lt;i&gt;<i>italic</i>&lt;/i&gt;, or
-	    &lt;tt&gt;<tt>teletype</tt>&lt;/tt&gt;.
-	    <p>Use &lt;pre&gt;</p>
-	    <pre>
+            </pre>
+            <p>
+              Above genpage command returns the string-quoted
+              genpage content tag as a string.</p>
+            <h3><a name="Gcffehd">Generate</a> .content files from existing .html documents</h3>
+            <p><a href="#index">Goto</a> Index</p>
+            <p>Use <a href="http://cvs.sourceforge.net/cgi-bin/cvsweb.cgi/xemacsweb/html2content.pl?cvsroot=xemacs">xemacsweb/html2content.pl</a>
+              to convert all .html files in a specified directory
+              (recursively) to .content files.  Existing .content
+              files will not be overwritten.</p>
+            <h3>Edit .html <a name="Ehfambtcf">file</a> and merge back to .content file</h3>
+            <p><a href="#index">Goto</a> Index</p>
+            <p>This gives you the power of your favorite HTML
+              editor (you are not using notepad, are you?) and
+              changes can easily be merged to the .content file with
+              <cite>ediff</cite>.</p>
+            <h3>Use <a name="Ul-cHt">lower</a>-case HTML tags</h3>
+            <p><a href="#index">Goto</a> Index</p>
+            <p>This is in preparation of a possible future
+              migration to <cite>XML</cite>.</p>
+            <h3>Use relative links <a name="Urlwp">wherever</a> possible</h3>
+            <p><a href="#index">Goto</a> Index</p>
+            <p>This makes site mirroring a free gift and allows
+              developers to test intra-site links in their private
+              working directories off-site.</p>
+            <h3>Use logical vs. physical <a name="Ulvpm">markup</a></h3>
+            <p><a href="#index">Goto</a> Index</p>
+            <p>It is a HTML authoring commandment to prefer logical
+              markups like &lt;blockquote&gt;</p>
+            <blockquote>
+              blockquote</blockquote>&lt;/blockquote&gt;,
+            &lt;strong&gt;<strong>strong</strong>&lt;/strong&gt;,
+            &lt;cite&gt;<cite>cite</cite>&lt;/cite&gt;,
+            &lt;samp&gt;<samp>samp</samp>&lt;/samp&gt; over
+            physical markup like &lt;br&gt;<br> linebreak<br>
+            &lt;br&gt;, &lt;b&gt;<b>bold</b>&lt;/b&gt;,
+            &lt;i&gt;<i>italic</i>&lt;/i&gt;, or
+            &lt;tt&gt;<tt>teletype</tt>&lt;/tt&gt;.
+            <p>Use &lt;pre&gt;</p>
+            <pre>
 Retrieving newsgroup: nnml:xemacs-beta...
 Fetching headers for nnml:xemacs-beta...
 Fetching headers for nnml:xemacs-beta...done
 Generating summary...done
 Decoding base64...
 Decoding base64... done</pre>
-	    &lt;/pre&gt; to include long runs of program output
-	    like error message logs or backtraces.  Don't forget
-	    to quote HTML special characters in such excerpts!  In
-	    XEmacs/PSGML this can be easily done with
-	    <pre>M-x <strong>html-quote-region</strong></pre>
-	    <h3>Use qq{<a name="Uq{s}nsigc">string</a>}, not "string" in genpage commands</h3>
-	    <p><a href="#index">Goto</a> Index</p>
-	    <p>All genpage commands (as opposed to genpage content
-	      tags) are embedded in HTML comments.  Whenever these
-	      commands are embedded inside an HTML attribute,
-	      embedded <cite>"</cite>s will produce an HTML
-	      validation error.</p>
-	    <p>Therefor, please use</p>
-	    <pre>&lt;a href="&lt;!-- _GP_ relPath(<strong>qq{</strong>Develop/devTeam.html<strong>}</strong>) --&gt;"&gt;Who Wrote XEmacs?&lt;/a&gt;</pre>
-	    <p>instead of</p>
-	    <pre>&lt;a href="&lt;!-- _GP_ relPath("Develop/devTeam.html") --&gt;"&gt;Who Wrote XEmacs?&lt;/a&gt;</pre>
+            &lt;/pre&gt; to include long runs of program output
+            like error message logs or backtraces.  Don't forget
+            to quote HTML special characters in such excerpts!  In
+            XEmacs this can be easily done with
+            <pre>M-x <strong>html-quote-region</strong></pre>
+            <h3>Use qq{<a name="Uq{s}nsigc">string</a>}, not "string" in genpage commands</h3>
+            <p><a href="#index">Goto</a> Index</p>
+            <p>All genpage commands (as opposed to genpage content
+              tags) are embedded in HTML comments.  Whenever these
+              commands are embedded inside an HTML attribute,
+              embedded <cite>"</cite>s will produce an HTML
+              validation error.</p>
+            <p>Therefor, please use</p>
+            <pre>&lt;a href="&lt;!-- _GP_ relPath(<strong>qq{</strong>Develop/devTeam.html<strong>}</strong>) --&gt;"&gt;Who Wrote XEmacs?&lt;/a&gt;</pre>
+            <p>instead of</p>
+            <pre>&lt;a href="&lt;!-- _GP_ relPath("Develop/devTeam.html") --&gt;"&gt;Who Wrote XEmacs?&lt;/a&gt;</pre>
             <hr>
             <p>This <a name="index">index</a> was generated by D:\Users\AichnerAd\pl\HTMLindex.pl -head</p>
             <ul>
               <li><a href="#GfC">Guidelines</a> for Contributors</li>
             </ul>
             <hr>
-	    <p>This <a name="index">index</a> was generated by d:\users\aichnerad\pl\HTMLindex.pl -head</p>
-	    <ul>
-	      <li><a href="#">Goto</a> Top</li>
-	      <li>XEmacs <a href="#XWoS">Website</a> on Sourceforge</li>
-	      <li>XEmacs <a href="#XWCR">Website</a> CVS Repository</li>
-	      <li>Automatic <a href="#AWU">Website</a> Update</li>
-	      <li>Automatic <a href="#AWV">Website</a> Validation</li>
-	      <li><a href="#Maclwg">Maintaining</a> a consistent look with genpage</li>
-	      <li>Relative Links <a href="#RLaMaO-sT">allow</a> Mirroring and Off-site Testing</li>
-	      <li><a href="#GfC">Guidelines</a> for Contributors</li>
-	      <li><a href="#Ccffnd">Create</a> .content files for new documentation</li>
-	      <li><a href="#Gcffehd">Generate</a> .content files from existing .html documents</li>
-	      <li>Edit .html <a href="#Ehfambtcf">file</a> and merge back to .content file</li>
-	      <li>Use <a href="#Ul-cHt">lower</a>-case HTML tags</li>
-	      <li>Use relative links <a href="#Urlwp">wherever</a> possible</li>
-	      <li>Use logical vs. physical <a href="#Ulvpm">markup</a></li>
-	      <li>Use qq{<a href="#Uq{s}nsigc">string</a>}, not "string" in genpage commands</li>
-	    </ul>
-	    <hr>
+            <p>This <a name="index">index</a> was generated by d:\users\aichnerad\pl\HTMLindex.pl -head</p>
+            <ul>
+              <li><a href="#">Goto</a> Top</li>
+              <li>XEmacs <a href="#XWoS">Website</a> on Sourceforge</li>
+              <li>XEmacs <a href="#XWCR">Website</a> CVS Repository</li>
+              <li>Automatic <a href="#AWU">Website</a> Update</li>
+              <li>Automatic <a href="#AWV">Website</a> Validation</li>
+              <li><a href="#Maclwg">Maintaining</a> a consistent look with genpage</li>
+              <li>Relative Links <a href="#RLaMaO-sT">allow</a> Mirroring and Off-site Testing</li>
+              <li><a href="#GfC">Guidelines</a> for Contributors</li>
+              <li><a href="#Ccffnd">Create</a> .content files for new documentation</li>
+              <li><a href="#Gcffehd">Generate</a> .content files from existing .html documents</li>
+              <li>Edit .html <a href="#Ehfambtcf">file</a> and merge back to .content file</li>
+              <li>Use <a href="#Ul-cHt">lower</a>-case HTML tags</li>
+              <li>Use relative links <a href="#Urlwp">wherever</a> possible</li>
+              <li>Use logical vs. physical <a href="#Ulvpm">markup</a></li>
+              <li>Use qq{<a href="#Uq{s}nsigc">string</a>}, not "string" in genpage commands</li>
+            </ul>
+            <hr>
             <address><a href="mailto: adrian@xemacs.org">Adrian</a> Aichner</address>