[cygwin-apps htdocs - The cygwin-apps website files] branch master, updated. 37023533aab8f3b7afbf628dcf35b92b664b4188

https://sourceware.org/git/gitweb.cgi?p=cygwin-apps/apps-htdocs.git;h=37023533aab8f3b7afbf628dcf35b92b664b4188

commit 37023533aab8f3b7afbf628dcf35b92b664b4188
Author: Jon Turney <[email protected]>
Date:   Tue Sep 7 14:38:00 2021 +0100

    Add checkout and push instructions for cygwin-apps repos
    
    Consistently use cygwin.com not sourceare.org for URLs
    Update setup instructions to point to cygwin-apps/setup
    Use a list for list of proejcts

https://sourceware.org/git/gitweb.cgi?p=cygwin-apps/apps-htdocs.git;h=0a6bc5cd7079759004444857ee7b551b00c9cd0a

commit 0a6bc5cd7079759004444857ee7b551b00c9cd0a
Author: Jon Turney <[email protected]>
Date:   Fri Jun 5 14:33:16 2020 +0100

    Document version-identifier


Diff:
---
 index.html     | 60 +++++++++++++++++++++++++++++++++++++---------------------
 setup.html     | 21 +++++++++++---------
 setup.ini.html |  9 ++++++---
 3 files changed, 56 insertions(+), 34 deletions(-)

diff --git a/index.html b/index.html
index f8c633d..bf1b3ac 100644
--- a/index.html
+++ b/index.html
@@ -14,31 +14,47 @@
 </div>
 
 <div id="main">
-<h2>This page acts as a reference for the various projects hosted in the cygwin-apps git repository.</h2>
+<h2>This page acts as a reference for the various projects hosted in the cygwin-apps git repositories.</h2>
 
-<p>The list of cygwin-apps projects under git control is available via GITWeb:<br>
-<a href="https://sourceware.org/git/gitweb.cgi?s=cygwin-apps">https://sourceware.org/git/gitweb.cgi?s=cygwin-apps</a>
+<p>The list of cygwin-apps projects under git control is available via gitweb:<br>
+<a href="https://cygwin.com/git/gitweb.cgi?s=cygwin-apps">https://cygwin.com/git/gitweb.cgi?s=cygwin-apps</a>
 </p>
 
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/base-files.git">base-files</a> - A set of important system configuration and setup files</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/calm.git">calm</a> - Cygwin server-side packaging maintenance script</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/crypt.git">crypt</a> - a library implementing the hopelessly outdated 56 bit DES encryption</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/csih.git">csih</a> - Cygwin service installation helper, a helper script and tools to create service installation scripts</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/cygport.git">cygport</a> - the Cygwin package building tool</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/cygrunsrv.git">cygrunsrv</a> - a wrapper for unix daemons to make them controllable as windows services</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/cygutils.git">cygutils</a> - Chuck Wilson's collection of Cygwin utilities</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/editrights.git">editrights</a> - A helper tool to change user privileges</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/genini.git">genini</a> - Script to create setup.ini files on a local machine</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/login.git">login</a> - The unix login(1), tweaked for Cygwin</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/mt.git">mt</a> - The unix mt(1) tool with Cygwin-specific extensions</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/rebase.git">rebase</a> - The rebase tool, core of the automatic rebase facility during postinstall</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/robots.git">robots</a> - The game; Fight against maniac robots</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/run.git">run</a> - Launch cmdline programs with hidden console</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/setup.git">setup</a> - the official Cygwin <a href="setup.html">setup</a> program used to install Cygwin and keep it up to date.</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/shutdown.git">shutdown</a> - Shutdown, reboot, hibernate or suspend the machine.</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/windows-default-manifest.git">windows-default-manifest</a> - The manifest each executable has to be linked against since Windows 8.1</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/xorg-doc.git">xorg-doc</a> - Cygwin XOrg documentation</p>
-<p><a href="https://cygwin.com/git/?p=cygwin-apps/htdocs.git">htdocs</a> - The cygwin-apps website files</p>
+<p>Check out the sources like this:
+
+<pre>
+git clone git://cygwin.com/git/cygwin-apps/<i>project</i>.git
+</pre>
+
+and, if you have commit rights on the repository (you will know if you do),
+configure pushing:
+
+<pre>
+git remote set-url origin --push ssh://<i>username</i>@cygwin.com/git/cygwin-apps/<i>project</i>.git
+</pre>
+</p>
+
+<ul>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/base-files.git">base-files</a> - A set of important system configuration and setup files</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/calm.git">calm</a> - Cygwin server-side packaging maintenance script</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/crypt.git">crypt</a> - a library implementing the hopelessly outdated 56 bit DES encryption</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/csih.git">csih</a> - Cygwin service installation helper, a helper script and tools to create service installation scripts</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/cygport.git">cygport</a> - the Cygwin package building tool</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/cygrunsrv.git">cygrunsrv</a> - a wrapper for unix daemons to make them controllable as windows services</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/cygutils.git">cygutils</a> - Chuck Wilson's collection of Cygwin utilities</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/editrights.git">editrights</a> - A helper tool to change user privileges</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/genini.git">genini</a> - Script to create setup.ini files on a local machine</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/login.git">login</a> - The unix login(1), tweaked for Cygwin</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/mt.git">mt</a> - The unix mt(1) tool with Cygwin-specific extensions</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/rebase.git">rebase</a> - The rebase tool, core of the automatic rebase facility during postinstall</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/robots.git">robots</a> - The game; Fight against maniac robots</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/run.git">run</a> - Launch cmdline programs with hidden console</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/setup.git">setup</a> - the official Cygwin <a href="setup.html">setup</a> program used to install Cygwin and keep it up to date.</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/shutdown.git">shutdown</a> - Shutdown, reboot, hibernate or suspend the machine.</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/windows-default-manifest.git">windows-default-manifest</a> - The manifest each executable has to be linked against since Windows 8.1</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/xorg-doc.git">xorg-doc</a> - Cygwin XOrg documentation</li>
+<li><a href="https://cygwin.com/git/?p=cygwin-apps/htdocs.git">htdocs</a> - The cygwin-apps website files</li>
+</ul>
 
 </div>
 
diff --git a/setup.html b/setup.html
index 67221b8..fe77099 100644
--- a/setup.html
+++ b/setup.html
@@ -18,7 +18,7 @@ is a tool for installing Cygwin over the internet, or from a local directory.
 <p>
 If you want information on how to use <tt>setup</tt> to install Cygwin,
 read the <a
-href="http://sourceware.org/cygwin/cygwin-ug-net/setup-net.html">Setting Up
+href="http://cygwin.com/cygwin/cygwin-ug-net/setup-net.html">Setting Up
 Cygwin</a> page.  For more information on creating packages that
 <tt>setup</tt> understands, read the <a href="http://cygwin.com/setup.html">
 Cygwin Packages</a> page.
@@ -34,24 +34,27 @@ Getting the source code from git and building
 </a>
 </h2>
 <p><tt>setup</tt> source code is available via git.  The sources can be
-<a href="https://sourceware.org/git/gitweb.cgi?p=cygwin-setup.git">
-viewed</a> using GitWeb. For development, check out the sources
-like this:
+<a href="https://cygwin.com/git/gitweb.cgi?p=cygwin-apps/setup.git">
+viewed</a> using gitweb.
+</p>
+
+<p>For development, check out the sources like this:
 
 <pre>
-git clone git://cygwin.com/git/cygwin-setup.git
+git clone git://cygwin.com/git/cygwin-apps/setup.git
 </pre>
 
-or, if you have commit rights on the repository (you know if you do),
-like this:
+and, if you have commit rights on the repository (you will know if you do),
+configure pushing:
 
 <pre>
-git clone cygwin.com:/git/cygwin-setup.git
+git remote set-url origin --push ssh://<i>username</i>@cygwin.com/git/cygwin-apps/setup.git
 </pre>
 </p>
+
 <p>For instructions on how to build <tt>setup</tt>, see the
 <tt><a
-    href="https://sourceware.org/git/gitweb.cgi?p=cygwin-setup.git;a=blob_plain;f=README;hb=HEAD"
+    href="https://cygwin.com/git/gitweb.cgi?p=cygwin-apps/setup.git;a=blob_plain;f=README;hb=HEAD"
     >README</a></tt>
 file included in its source.</p>
 
diff --git a/setup.ini.html b/setup.ini.html
index bdfb073..771d7a9 100644
--- a/setup.ini.html
+++ b/setup.ini.html
@@ -132,9 +132,12 @@ be replaced with the curr: version, even if it is lower.</p>
   exists).
 </p>
 
-<p><tt>version: <i>version</i></tt></p>
+<p><tt>version: <i>version-identifier</i></tt></p>
 <p>Indicates the version of the package.</p>
 
+<p><tt><i>version-identifier</i></tt> is a non-empty sequence of alphanumeric
+    and <tt>-!./:\_~+</tt> punctuation characters</p>
+
 <p><tt>install: <i>filename</i> <i>size-in-bytes</i> <i>hash</i></tt></p>
 <p>Indicates the archive file to install for that version, and its size in
 bytes, and a checksum. The file name must include the path (relative to the base
@@ -172,12 +175,12 @@ package satisfies.</p>
 
 <h4>Note: The following directives are not fully implemented yet.</h4>
 
-<p><tt>Build-Depends: <i>version-relations</i></i></tt></p>
+<p><tt>build-depends: <i>version-relations</i></i></tt></p>
 <p>Indicates the binary packages required to build the source package.</p>
 
 <h4 id="relationship">Syntax of relationship fields</h4>
 
-<p><tt>Depends:</tt>, <tt>Obsoletes:</tt>, <tt>Build-Depends:</tt> all have a
+<p><tt>depends:</tt>, <tt>obsoletes:</tt>, <tt>build-depends:</tt> all have a
   common syntax.  They are a list of package names separated by commas.  They
   may restrict their applicability to particular versions of each named package.
   This is done in parentheses after each package name.  The parentheses should