n0nick Wed May 1 11:36:22 2002 EDT
Modified files:
/phpdoc/he/appendices about.xml
Log:
I'm done. Somebody review this.
Index: phpdoc/he/appendices/about.xml
diff -u phpdoc/he/appendices/about.xml:1.1 phpdoc/he/appendices/about.xml:1.2
--- phpdoc/he/appendices/about.xml:1.1 Tue Apr 30 20:59:11 2002
+++ phpdoc/he/appendices/about.xml Wed May 1 11:36:21 2002
@@ -17,8 +17,6 @@
<para>
����� PHP ���� ����� ������. ������ ��� ������ ������ ���� ������:
������ ����� ����� ����� ����� ������� ������-������.
- The PHP manual is provided in several formats. These formats can be divided
- into two groups: online readable formats, and downloadable packages.
</para>
<note>
<para>
@@ -104,92 +102,86 @@
</sect1>
<sect1 id="about.more">
- <title>How to find more information about PHP</title>
+ <title>���� ���� ���� ���� ����� PHP</title>
<para>
- This manual does not attempt to provide instruction about general
- programming practices. If you are a first-time, or even just a beginning,
- programmer, you may find it difficult to learn how to program in PHP using
- just this manual. You may want to seek out a text more oriented towards
- beginners. You can find a list of PHP-related books at <ulink
- url="&url.php.books;">&url.php.books;</ulink>.
- </para>
- <para>
- There are a number of active mailing lists for discussion of all aspects of
- programming with PHP. If you find yourself stuck on a problem for which you
- can't find your own solution, you may be able to get help from someone on
- these lists. You can find a list of the mailing lists at <ulink
- url="&url.php.support;">&url.php.support;</ulink>, as well as links to the
- mailing list archives and other online support resources. Furthermore, at
- <ulink url="&url.php.links;">&url.php.links;</ulink> there is a list of
- websites devoted to PHP articles, forums, and code galleries.
+ ����� �� �� ���� ���� ������ ����� ������ ����� ������.
+ �� ��� ����� ���� �������, �� ����� �� ����� �����, ���� ����
+ ������ ����� �-PHP ������� ����� �� ���� ���.
+ ���� ����� ���� ������ ���� ��������. ��� ���� ����� ����� ��
+ ����� ������� �-PHP � <ulink url="&url.php.books;">&url.php.books;</ulink>.
+ </para>
+ <para>
+ ���� ���� ������ ����� ������ ����� �� ������� �� ����� �� PHP.
+ �� ���� ��� ����� ���� �� ����� ����� �� �����, �������� ���� ����
+ ������ ������� ���. ���� ����� ����� �� ������ ������ � <ulink
+ url="&url.php.support;">&url.php.support;</ulink>, ��� �� �������
+ ������� ����� ������� �����. �����, � <ulink
+ url="&url.php.links;">&url.php.links;</ulink> ���� ����� �� �����
+ �������� �������, ������� ������� ��� �� PHP.
</para>
</sect1>
<sect1 id="about.howtohelp">
- <title>How to help improve the documentation</title>
+ <title>���� ���� ����� ������ ������</title>
<para>
- There are two ways you can help to improve this documentation.
+ ���� ��� ����� ����� ������ ����� ��.
</para>
<para>
- If you find errors in this manual, in any language, please report them
- using the bug system at <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>.
- Classify the bug as "Documentation Problem". You can also submit problems
- related to specific manual formats here.
+ �� ��� ���� ������ ������ ��, ��� ���, ��� ���� ����� ������� ����� ������
+ � <ulink url="&url.php.bugs;">&url.php.bugs;</ulink>.
+ ���� �� ���� �"����� �����" ("Documentation Problem"). ��� ���� ����� �� ��
+ ����� ������� ������� ������� �� ������ ���.
</para>
<note>
<para>
- Please don't abuse the bug system by submitting requests for help. Use the
- mailing lists or community sites mentioned earlier, instead.
+ ��� �� ����� ���� ������ ������ �"� ����� ����� �����. ����� ������� ������
+ ������ ������ ������ ���� �����.
</para>
</note>
<para>
- By contributing notes, you can provide additional examples, caveats, and
- clarifications for other readers. But do not submit bug reports using the
- annotation system please. You can read more about annotations in the <link
- linkend="about.notes">'About user notes'</link> section of this
- appendix.
+ ��-��� ����� �����, ��� ���� ���� ������� ������, ������ ������� �������
+ ������. �� ����� �� ����� �� ����� ������� ����� ��������. ���� ����� ���
+ �� �������� ���� <link linkend="about.notes">'����� ����� ��������'</link>
+ �� ���� ��.
</para>
</sect1>
<sect1 id="about.generate">
- <title>How we generate the formats</title>
+ <title>���� ��� ������� �� �������</title>
<para>
- This manual is written in <acronym>XML</acronym> using the <ulink
- url="&url.docbook.xml;">DocBook XML DTD</ulink>, using <ulink
+ ����� �� ���� � <acronym>XML</acronym> ������ � <ulink
+ url="&url.docbook.xml;">DocBook XML DTD</ulink>, ������ � <ulink
url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document
- Style and Semantics Specification Language) for formatting, and
- experimentally the <ulink url="&url.xslt;"><acronym>XSLT</acronym>
+ Style and Semantics Specification Language) ������, ������ ������� �
+ <ulink url="&url.xslt;"><acronym>XSLT</acronym>
</ulink> (Extensible Stylesheet Language Transformations)
- for maintenance and formatting.
+ ������ ������.
</para>
<para>
- Using <acronym>XML</acronym> as a source format gives us
- the ability to generate many output formats from the source
- files, while only maintaining one source document for all formats.
- The tools used for formatting <acronym>HTML</acronym> and
- <acronym>TeX</acronym> versions are
- <ulink url="&url.jade;">Jade</ulink>, written by <ulink
- url="&url.jclark;">James Clark</ulink> and <ulink
+ ������ � <acronym>XML</acronym> ������ ���� ����� ���
+ ����� ��� ������� ���� ����� �����, ��� ����� ���� ����
+ ��� ���� �� �������.
+ ����� ������ ������ �-<acronym>HTML</acronym> ��-<acronym>TeX</acronym>
+ �� <ulink url="&url.jade;">Jade</ulink>, ����� �"� <ulink
+ url="&url.jclark;">�'���� �����</ulink> � <ulink
url="&url.dbstyle;">The Modular DocBook Stylesheets</ulink>
- written by <ulink url="&url.nwalsh;">Norman Walsh</ulink>.
- We use <ulink url="&url.winhelp;">Microsoft HTML Help
- Workshop</ulink> to generate the Windows HTML Help format
- of the manual, and of course PHP itself to do some
- additional conversions and formatting.
+ ������ �"� <ulink url="&url.nwalsh;">����� ����</ulink>.
+ ��� ������� �<ulink url="&url.winhelp;">���� ���� HTML ��
+ ���������</ulink> ��� ����� �� ������ ���� �-HTML �������
+ �� ������, ������ PHP ���� ����� ���� ����� �������� �����.
</para>
<para>
- You can download the manual in various languages and
- formats, including plain text, plain <acronym>HTML</acronym>,
- <acronym>PDF</acronym>, PalmPilot DOC, PalmPilot iSilo and
- Windows HTML Help, from
+ ���� ������ �� ������ ����� ������� �����, ��� ���� ����� ����,
+ <acronym>HTML</acronym> ����, <acronym>PDF</acronym>, PalmPilot DOC,
+ PalmPilot iSilo ����� HTML �������, �
<ulink url="&url.php.docs;">&url.php.docs;</ulink>.
- The manuals are updated automatically as the text is updated.
+ �������� �������� ����� ������� ������� ������.
</para>
<para>
- You can find more information about downloading the
- <acronym>XML</acronym> source code of this documentation
- at <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. The
- documentation is stored in the <literal>phpdoc</literal> module.
+ ���� ����� ���� ���� ����� ����� ��� ����� �
+ <acronym>XML</acronym> �� ����� �� �
+ <ulink url="&url.php.cvs;">&url.php.cvs;</ulink>. ������
+ ������ ������ <literal>phpdoc</literal>.
</para>
</sect1>