]> granicus.if.org Git - apache/commitdiff
new XML
authorAndré Malo <nd@apache.org>
Thu, 1 May 2003 00:39:17 +0000 (00:39 +0000)
committerAndré Malo <nd@apache.org>
Thu, 1 May 2003 00:39:17 +0000 (00:39 +0000)
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@99669 13f79535-47bb-0310-9956-ffa450edef68

docs/STATUS
docs/man/htdigest.1
docs/manual/programs/htdigest.html [deleted file]
docs/manual/programs/htdigest.html.en [new file with mode: 0644]
docs/manual/programs/htdigest.xml [new file with mode: 0644]
docs/manual/programs/htdigest.xml.meta [new file with mode: 0644]
docs/manual/style/chm/hhc.xsl

index ced5efe8dace39e9acca0e666c6763602b2bc1c0..ca4543ee0db9f8aa7af532f8252d8b81d9b94095 100644 (file)
@@ -1,5 +1,5 @@
 Apache HTTP Server 2.1 Documentation Status File.
-Last modified: $Date: 2003/04/30 23:25:08 $
+Last modified: $Date: 2003/05/01 00:39:16 $
 
 For more information on how to contribute to the Apache Documentation
 Project, please see http://httpd.apache.org/docs-project/
@@ -189,6 +189,5 @@ http://httpd.apache.org/docs-project/docsformat.html
 developer/API.html
 
 # converting from nroff to xml
-programs/htdigest.html
 programs/htpasswd.html
 programs/other.html
index 717718fec73eb6a62e95f04bfaf449ea23282fff..92c45d28055221e9790e1f3fab065655ccc0f792 100644 (file)
@@ -1,95 +1,59 @@
-.TH htdigest 1 "January 2001"
-.\" The Apache Software License, Version 1.1
-.\"
-.\" Copyright (c) 2000-2003 The Apache Software Foundation.  All rights
-.\" reserved.
-.\"
-.\" Redistribution and use in source and binary forms, with or without
-.\" modification, are permitted provided that the following conditions
-.\" are met:
-.\"
-.\" 1. Redistributions of source code must retain the above copyright
-.\"    notice, this list of conditions and the following disclaimer.
-.\"
-.\" 2. Redistributions in binary form must reproduce the above copyright
-.\"    notice, this list of conditions and the following disclaimer in
-.\"    the documentation and/or other materials provided with the
-.\"    distribution.
-.\"
-.\" 3. The end-user documentation included with the redistribution,
-.\"    if any, must include the following acknowledgment:
-.\"       "This product includes software developed by the
-.\"        Apache Software Foundation (http://www.apache.org/)."
-.\"    Alternately, this acknowledgment may appear in the software itself,
-.\"    if and wherever such third-party acknowledgments normally appear.
-.\"
-.\" 4. The names "Apache" and "Apache Software Foundation" must
-.\"    not be used to endorse or promote products derived from this
-.\"    software without prior written permission. For written
-.\"    permission, please contact apache@apache.org.
-.\"
-.\" 5. Products derived from this software may not be called "Apache",
-.\"    nor may "Apache" appear in their name, without prior written
-.\"    permission of the Apache Software Foundation.
-.\"
-.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
-.\" WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
-.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
-.\" DISCLAIMED.  IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
-.\" ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-.\" SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-.\" LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
-.\" USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
-.\" ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
-.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
-.\" SUCH DAMAGE.
-.\"
-.\" This software consists of voluntary contributions made by many
-.\" individuals on behalf of the Apache Software Foundation.  For more
-.\" information on the Apache Software Foundation, please see
-.\" <http://www.apache.org/>.
-.\"
+.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+.\" DO NOT EDIT! Generated from XML source.
+.\" XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+.de Sh \" Subsection
+.br
+.if t .Sp
+.ne 5
+.PP
+\fB\\$1\fR
+.PP
+..
+.de Sp \" Vertical space (when we can't use .PP)
+.if t .sp .5v
+.if n .sp
+..
+.de Ip \" List item
+.br
+.ie \\n(.$>=3 .ne \\$3
+.el .ne 3
+.IP "\\$1" \\$2
+..
+.TH "HTDIGEST" 1 "2003-05-01" "Apache HTTP Server" "htdigest"
+
 .SH NAME
-htdigest \- Create and update user authentication files
-.SH SYNOPSIS
-.B htdigest 
-[
-.B \-c
-] 
-.I passwdfile
-.I realm
-.I username
-.SH DESCRIPTION
-.B htdigest
-is used to create and update the flat-files used to store
-usernames, realm and password for digest authentication of HTTP users.
-Resources available from the
-.B httpd
-Apache web server can be restricted to just the users listed
-in the files created by 
-.B htdigest.
+htdigest \- manage user files for digest authentication
+
+.SH "SYNOPSIS"
+.PP
+\fBhtdigest\fR [ -\fBc\fR ] \fIpasswdfile\fR \fIrealm\fR \fIusername\fR
+
+.SH "SUMMARY"
+.PP
+htdigest is used to create and update the flat-files used to store usernames, realm and password for digest authentication of HTTP users\&. Resources available from the Apache HTTP server can be restricted to just the users listed in the files created by htdigest\&.
 .PP
-This manual page only lists the command line arguments. For details of
-the directives necessary to configure digest authentication in 
-.B httpd 
-see
-the Apache manual, which is part of the Apache distribution or can be
-found at http://www.apache.org/.
-.SH OPTIONS
-.IP \-c 
-Create the \fIpasswdfile\fP. If \fIpasswdfile\fP already exists, it
-is deleted first. 
-.IP \fB\fIpasswdfile\fP
-Name of the file to contain the username, realm and password. If \-c
-is given, this file is created if it does not already exist,
-or deleted and recreated if it does exist. 
-.IP \fB\fIrealm\fP
-The realm name to which the user name belongs. 
-.IP \fB\fIusername\fP
-The user name to create or update in \fBpasswdfile\fP. If
-\fIusername\fP does not exist is this file, an entry is added. If it
-does exist, the password is changed.
-.SH SEE ALSO
-.BR httpd(8) 
-.
+This manual page only lists the command line arguments\&. For details of the directives necessary to configure digest authentication in httpd see the Apache manual, which is part of the Apache distribution or can be found at http://httpd\&.apache\&.org/\&.
+
+.SH "OPTIONS"
+.RS
+.TP
+-c
+Create the \fIpasswdfile\fR\&. If \fIpasswdfile\fR already exists, it is deleted first\&.  
+.TP
+\fIpasswdfile\fR
+Name of the file to contain the username, realm and password\&. If -c is given, this file is created if it does not already exist, or deleted and recreated if it does exist\&.  
+.TP
+\fIrealm\fR
+The realm name to which the user name belongs\&.  
+.TP
+\fIusername\fR
+The user name to create or update in \fIpasswdfile\fR\&. If \fIusername\fR does not exist is this file, an entry is added\&. If it does exist, the password is changed\&.  
+.RE
diff --git a/docs/manual/programs/htdigest.html b/docs/manual/programs/htdigest.html
deleted file mode 100644 (file)
index 545839e..0000000
+++ /dev/null
@@ -1,74 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
-    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta name="generator" content="HTML Tidy, see www.w3.org" />
-
-    <title>Manual Page: htdigest - Apache HTTP Server</title>
-  </head>
-
-  <body bgcolor="#ffffff" text="#000000" link="#0000ff"
-  vlink="#000080" alink="#ff0000">
-        <div align="center">
-      <img src="../images/sub.gif" alt="[APACHE DOCUMENTATION]" /> 
-
-      <h3>Apache HTTP Server Version 2.1</h3>
-    </div>
-
-
-
-    <h1 align="center">Manual Page: htdigest</h1>
-    <!-- This document was autogenerated from the man page -->
-<pre>
-<strong>NAME</strong>
-     htdigest - Create and update user authentication files
-
-<strong>SYNOPSIS</strong>
-     <strong>htdigest</strong> [ -<strong>c</strong> ] <em>passwdfile realm username</em>
-
-<strong>DESCRIPTION</strong>
-     <strong>htdigest</strong> is used to create and update the flat-files used to
-     store  usernames,  realm and password for digest authentica-
-     tion of HTTP users.   Resources  available  from  the  <strong>httpd</strong>
-     Apache web server can be restricted to just the users listed
-     in the files created by <strong>htdigest.</strong>
-
-     This manual page only lists the command line arguments.  For
-     details  of  the  directives  necessary  to configure digest
-     authentication in <strong>httpd</strong> see the Apache manual, which is part
-     of   the   Apache   distribution   or   can   be   found  at
-     http://www.apache.org/.
-
-<strong>OPTIONS</strong>
-     -c   Create the <em>passwdfile</em>. If <em>passwdfile</em> already exists, it
-          is deleted first.
-
-     <em>passwdfile</em>
-          Name of the file to contain  the  username,  realm  and
-          password.  If  -c  is given, this file is created if it
-          does not already exist, or deleted and recreated if  it
-          does exist.
-
-     <em>realm</em>
-          The realm name to which the user name belongs.
-
-     <em>username</em>
-          The user name to create or  update  in  <strong>passwdfile</strong>.  If
-          <em>username</em>  does  not  exist  is  this  file, an entry is
-          added. If it does exist, the password is changed.
-
-<strong>SEE ALSO</strong>
-     <strong>httpd(8)</strong>
-
-</pre>
-        <hr />
-
-    <h3 align="center">Apache HTTP Server Version 2.1</h3>
-    <a href="./"><img src="../images/index.gif" alt="Index" /></a>
-    <a href="../"><img src="../images/home.gif" alt="Home" /></a>
-
-
-  </body>
-</html>
-
diff --git a/docs/manual/programs/htdigest.html.en b/docs/manual/programs/htdigest.html.en
new file mode 100644 (file)
index 0000000..859d65a
--- /dev/null
@@ -0,0 +1,64 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      -->
+<title>htdigest - manage user files for digest authentication - Apache HTTP Server</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p>
+<p class="apache">Apache HTTP Server Version 2.1</p>
+<img alt="" src="../images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs-project/">Documentation</a> &gt; <a href="../">Version 2.1</a> &gt; <a href="./">Programs</a></div><div id="page-content"><div id="preamble"><h1>htdigest - manage user files for digest authentication</h1>
+    <p><code>htdigest</code> is used to create and update the flat-files used
+    to store usernames, realm and password for digest authentication of HTTP
+    users. Resources available from the Apache HTTP server can be restricted
+    to just the users listed in the files created by <code>htdigest</code>.</p>
+
+    <p>This manual page only lists the command line arguments. For details of
+    the directives necessary to configure digest authentication in
+    <a href="httpd.html">httpd</a> see the Apache manual, which is part
+    of the Apache distribution or can be found at
+    <a href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
+</div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#synopsis">Synopsis</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#options">Options</a></li>
+</ul><h3>See also</h3><ul class="seealso"><li><a href="httpd.html">httpd</a></li><li><code class="module"><a href="../mod/mod_auth_digest.html">mod_auth_digest</a></code></li></ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="synopsis" id="synopsis">Synopsis</a></h2>
+    <p><code><strong>htdigest</strong> [ -<strong>c</strong> ]
+    <var>passwdfile</var> <var>realm</var> <var>username</var></code></p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="options" id="options">Options</a></h2>
+    <dl>
+    <dt><code>-c</code></dt>
+    <dd>Create the <var>passwdfile</var>. If <var>passwdfile</var> already
+    exists, it is deleted first.</dd>
+
+    <dt><code><var>passwdfile</var></code></dt>
+    <dd>Name of the file to contain the username, realm and password. If
+    <code>-c</code> is given, this file is created if it does not already
+    exist, or deleted and recreated if it does exist.</dd>
+
+    <dt><code><var>realm</var></code></dt>
+    <dd>The realm name to which the user name belongs.</dd>
+
+    <dt><code><var>username</var></code></dt>
+    <dd>The user name to create or update in <var>passwdfile</var>. If
+    <var>username</var> does not exist is this file, an entry is added. If it
+    does exist, the password is changed.</dd>
+    </dl>
+</div></div>
+<div id="footer">
+<p class="apache">Maintained by the <a href="http://httpd.apache.org/docs-project/">Apache HTTP Server Documentation Project</a></p>
+<p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="../faq/">FAQ</a> | <a href="../glossary.html">Glossary</a> | <a href="../sitemap.html">Sitemap</a></p></div>
+</body></html>
\ No newline at end of file
diff --git a/docs/manual/programs/htdigest.xml b/docs/manual/programs/htdigest.xml
new file mode 100644 (file)
index 0000000..a20ac79
--- /dev/null
@@ -0,0 +1,50 @@
+<?xml version='1.0' encoding='UTF-8' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
+<manualpage metafile="htdigest.xml.meta">
+<parentdocument href="./">Programs</parentdocument>
+
+<title>htdigest - manage user files for digest authentication</title>
+
+<summary>
+    <p><code>htdigest</code> is used to create and update the flat-files used
+    to store usernames, realm and password for digest authentication of HTTP
+    users. Resources available from the Apache HTTP server can be restricted
+    to just the users listed in the files created by <code>htdigest</code>.</p>
+
+    <p>This manual page only lists the command line arguments. For details of
+    the directives necessary to configure digest authentication in
+    <a href="httpd.html">httpd</a> see the Apache manual, which is part
+    of the Apache distribution or can be found at
+    <a href="http://httpd.apache.org/">http://httpd.apache.org/</a>.</p>
+</summary>
+<seealso><a href="httpd.html">httpd</a></seealso>
+<seealso><module>mod_auth_digest</module></seealso>
+
+<section id="synopsis"><title>Synopsis</title>
+    <p><code><strong>htdigest</strong> [ -<strong>c</strong> ]
+    <var>passwdfile</var> <var>realm</var> <var>username</var></code></p>
+</section>
+
+<section id="options"><title>Options</title>
+    <dl>
+    <dt><code>-c</code></dt>
+    <dd>Create the <var>passwdfile</var>. If <var>passwdfile</var> already
+    exists, it is deleted first.</dd>
+
+    <dt><code><var>passwdfile</var></code></dt>
+    <dd>Name of the file to contain the username, realm and password. If
+    <code>-c</code> is given, this file is created if it does not already
+    exist, or deleted and recreated if it does exist.</dd>
+
+    <dt><code><var>realm</var></code></dt>
+    <dd>The realm name to which the user name belongs.</dd>
+
+    <dt><code><var>username</var></code></dt>
+    <dd>The user name to create or update in <var>passwdfile</var>. If
+    <var>username</var> does not exist is this file, an entry is added. If it
+    does exist, the password is changed.</dd>
+    </dl>
+</section>
+
+</manualpage>
diff --git a/docs/manual/programs/htdigest.xml.meta b/docs/manual/programs/htdigest.xml.meta
new file mode 100644 (file)
index 0000000..aee97a0
--- /dev/null
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+
+<metafile>
+  <basename>htdigest</basename>
+  <path>/programs/</path>
+  <relpath>..</relpath>
+
+  <variants>
+    <variant>en</variant>
+  </variants>
+</metafile>
index 75e2906babd074ce9ef6610cdc3832889dcf05e7..fed94b37b37ff73f16f3150adde119e1c1135aa2 100644 (file)
@@ -84,7 +84,6 @@
 <!-- documents not converted (yet?). -->
 <not-exists>
     <file>developer/API.xml</file>
-    <file>programs/htdigest.xml</file>
     <file>programs/htpasswd.xml</file>
     <file>programs/other.xml</file>
 </not-exists>