discussion: ease of translation

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