hi,
while translating openssl to german following comes to my mind and I wanna ask
for your opinion. Paremeter <notext> is used by four functions, with identical
purpose and description. Instead of repeating the same description 'many'
times, it seems more convinient to have the description in one place and
'include' it where approptiate (similar to entities, but just extensionwise
like openssl/note-openssl-cnf.xml introduced some time ago by wez).
This would result in placing parameter-notext.xml in /refernce/openssl/ and
linking &refernce.openssl.parameter-notext; the files in question.
advantage:
- write once, consistent, use often ;-)
- speeds up translations, translate once and be sure you are done ;-)
disadvantage:
- cluttering of /reference/{extension} main directory
for example:
"/usr/bin/cvs" -z6 diff "openssl-csr-export-to-file.xml"
Index: openssl-csr-export-to-file.xml
===================================================================
RCS file:
/repository/phpdoc/en/reference/openssl/functions/openssl-csr-export-to-file.xml,v
retrieving revision 1.4
diff -u -r1.4 openssl-csr-export-to-file.xml
--- openssl-csr-export-to-file.xml 10 Dec 2002 19:13:48 -0000 1.4
+++ openssl-csr-export-to-file.xml 24 Mar 2003 13:03:08 -0000
@@ -18,11 +18,8 @@
<function>openssl_csr_export_to_file</function> takes the Certificate
Signing Request represented by <parameter>csr</parameter> and saves it
as ascii-armoured text into the file named by
<parameter>outfilename</parameter>.
+ &reference.openssl.parameter-notext;
&return.success;
- The optional <parameter>notext</parameter> affects
- the verbosity of the output; if it is &false; then additional
human-readable information is included
- in the output. The default value of <parameter>notext</parameter> is
- &true;
</para>
<simpara>
See also <function>openssl_csr_export</function>,
and parameter-notext.xml:
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
The optional <parameter>notext</parameter> affects
the verbosity of the output; if it is &false; then additional human-readable
information is included in the output. The default value of
<parameter>notext</parameter> is &true;.
....
opinions?
Friedhelm
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
