Return-Path: 
 <docs-return-7885-apmail-httpd-docs-archive=httpd.apache.org@httpd.apache.org>
Delivered-To: apmail-httpd-docs-archive@www.apache.org
Received: (qmail 80039 invoked from network); 19 Aug 2007 11:17:37 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2)
  by minotaur.apache.org with SMTP; 19 Aug 2007 11:17:37 -0000
Received: (qmail 58392 invoked by uid 500); 19 Aug 2007 11:17:34 -0000
Delivered-To: apmail-httpd-docs-archive@httpd.apache.org
Received: (qmail 58353 invoked by uid 500); 19 Aug 2007 11:17:33 -0000
Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:docs-help@httpd.apache.org>
list-unsubscribe: <mailto:docs-unsubscribe@httpd.apache.org>
List-Post: <mailto:docs@httpd.apache.org>
Reply-To: docs@httpd.apache.org
List-Id: <docs.httpd.apache.org>
Delivered-To: mailing list docs@httpd.apache.org
Received: (qmail 58342 invoked by uid 99); 19 Aug 2007 11:17:33 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 19 Aug 2007 04:17:33 -0700
X-ASF-Spam-Status: No, hits=-0.0 required=10.0
	tests=SPF_PASS
X-Spam-Check-By: apache.org
Received-SPF: pass (athena.apache.org: local policy)
Received: from [217.160.171.50] (HELO jupiter.hal-nine-zero-zero-zero.net)
 (217.160.171.50)
    by apache.org (qpsmtpd/0.29) with SMTP; Sun, 19 Aug 2007 11:17:28 +0000
Received: (qmail 21656 invoked from network); 19 Aug 2007 11:17:06 -0000
Received: from unknown (HELO p54A32875.dip0.t-ipconnect.de) (84.163.40.117)
  by jupiter.hal-nine-zero-zero-zero.net with SMTP; 19 Aug 2007 11:17:06 -0000
From: =?iso-8859-1?q?Andr=E9_Malo?= <nd@perlig.de>
Organization: TIMTOWTDI
To: docs@httpd.apache.org
Subject: Re: Password Encryptions transformation
Date: Sun, 19 Aug 2007 13:16:53 +0200
User-Agent: KMail/1.9.7
References: <813716b60708190220x6ba852cbt73b15d8706788ba6@mail.gmail.com>
In-Reply-To: <813716b60708190220x6ba852cbt73b15d8706788ba6@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain;
  charset="iso-8859-6"
Content-Transfer-Encoding: 7bit
Content-Disposition: inline
Message-Id: <200708191316.56653@news.perlig.de>
X-Virus-Checked: Checked by ClamAV on apache.org

* Vincent Bray wrote:

> Hi kids,
>
> Following from Tom Donovan's work on
> http://wiki.apache.org/httpd/EncryptedPasswords I thought I'd have a
> pop at converting it to xdocs. The result is attached.
>
> It builds ok, and the result isn't too shaby, but ./build.sh
> validate-xml fails with:
>
> validate-xml:
> [xmlvalidate]
> /Users/noodl/Apache/httpd-trunk/docs/manual/misc/password_encryptions.xml
>:158:15: The content of element type "section" must match
> "(title,related?,(section|p|example|note|table|ul|ol|dl|pre|blockquote)*)
>". [xmlvalidate]
> /Users/noodl/Apache/httpd-trunk/docs/manual/misc/password_encryptions.xml
> is not a valid XML document
> [xmlvalidate] 456 file(s) have been successfully validated.
>
> I'm having trouble see where I went wrong, as the first section
> contains only title, section, p, and dl elements. What did I mess up?

It's later:

<p>C or C++</p>
Use the APR function: <a 
href="http://apr.apache.org/docs/apr-util/1.2/apr__sha1_8h.html#38a5ac487992a24e941b7501273829e8">apr_sha1_base64</a>

> Also, as this is my first go at producing a whole document, please
> don't be shy telling me what I've messed up. In particular I think I
> may have used too many nested section elements.

The xslt will bail if you've nested too deep :)

> In my trunk working copy, this file is
> docs/manual/misc/password_encryptions.xml
>
> Is that name ok? There's a few different combinations of
> squishedworks, under_scored_names and hyphenated-gubbins in that
> directory.

I personally tend to hyphens, but the trend seems to be underscores. I'd 
say, choose whatever you want, but keep it then (stable URLs are cool).

Issues to consider:
* The document needs to be entered into the sitemap
* don't forget the set svn:keywords to LastChangedRevision on checkin

(I didn't review the content)

Thanks, nd
-- 
"Umfassendes Werk (auch fuer Umsteiger vom Apache 1.3)"
                                          -- aus einer Rezension

<http://pub.perlig.de/books.html#apache2>

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org