cvs: phpdoc-sk /appendices license.xml migration5.xml

[email protected] ("Joseph Drake") Thu, 12 Feb 2004 00:12:22 -0000
Newsgroups php.doc.sk
Message-ID <cvsjoseph1076544742@cvsserver>
joseph		Wed Feb 11 19:12:22 2004 EDT

  Added files:                 
    /phpdoc-sk/appendices	license.xml migration5.xml 
  Log:
  new document
joseph-20040211191222.txt (text/plain, 12.7 KB)
http://cvs.php.net/co.php/phpdoc-sk/appendices/license.xml?r=1.1&p=1
Index: phpdoc-sk/appendices/license.xml
+++ phpdoc-sk/appendices/license.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.1 Maintainer: joseph Status: ready -->
<appendix id="opl.license">
 <title>Open Publication License</title>
  <simpara>v1.0, 8 June 1999</simpara>
  <section id="opl.require">
   <title>I. PO®IADAVKY NA NEMODOFIKOVANÚ A MODIFIKOVANÚ VERZIU</title>
   <simpara>
    Práce Open Publication sa mô¾u reprodukova» a distribuova» v celku alebo
    po èastiach, na akomkoµvek fyzickom èi elektronickom médiu, prièom sú
    podmienky tejto licencie dodr¾ané a táto licencia alebo jej zaèlenenie
    podµa referencie (so v¹etkými voµbami zvolenými autorom(-mi)
    a/alebo vydávateµom) je zobrazené v reprodukcii.
   </simpara>
   <simpara>
    Vhodná forma pre zaèlenenie podµa referencie je následovná:
   </simpara>
   <para>
    Copyright (c) &lt;rok&gt; by &lt;autorové meno alebo dizajnér&gt;. Tento
    materiál sa mo¾e distribuova» iba v rámci po¾iadavok a sadou podmienok
    v Open Publication License, vX.Y alebo neskor¹ej (najnov¹ia verzia
    je momentálne dostupná na <ulink url="&url.opl;">&url.opl;</ulink>
    </para>
   <simpara>
    Za referenciou musia okma¾ite následova» v¹etky voµby zvolené autorom(-mi)
    a/alebo vydávateµom tohto dokumentu (pozri sekciu VI).
    Komerèná redistribúcia materiálu lincencovaného Open Publication je
    povolená. V¹etky publikácie v ¹tandardnej (papierovej) kni¾nej forme
    vy¾adujú citáciu originálneho vydávateµa alebo autora. Vydávateµ a
    mená autorov musia by» viditeµné na v¹etkých vonkaj¹ích povrchoch knihy.
    Na v¹etkých vonkaj¹ích povrchoch knihy by meno vydávateµa malo by» tak
    veµké ako je titul práce a citované ako vlastnické s re¹pektom k
    titulu.
   </simpara>
  </section>

  <section id="opl.copyright">
   <title>II. AUTORSKÉ PRÁVA</title>
   <simpara>
    Autorské práva ka¾dej Open Publication sú vlastnené svojim autorom(-mi) alebo dizajnérom.
   </simpara>
  </section>

  <section id="opl.scope">
   <title>III. ROZSAH LICENCIE</title>
   <simpara>
    Podmienky následujúcej licencie sa vz»ahujú na v¹etky práce Open
    Publication, pokiaµ explicitne nie je v dokumente uvedené inak.
   </simpara>
   <simpara>
    Èistá agregácia prác Open Publication alebo porcia práce Open
    Publication s inými prácami alebo programami na rovnakom médiu nespôsobí,
    ¾e sa táto licencia vz»ahuje na tieto iné práce. Agregátna práca by mala
    obsahova» zmienku urèujúcu zahrnutie materiálu Open Publication a
    príslu¹nú zmienku o autorských právach.
   </simpara>
   <simpara>
    ODDELITE¥NONOS«. Ak sa nejaká èas» tejto licencie javý ako nevykonateµná v
    akejkoveµvek jurisdikcii, zostávajúce porcie licencie zostávajú nutnos»ou.
   </simpara>
   <simpara>
    ®IADNA ZÁRUKA. Práce Open Publication sú licencované a poskytované "ako je"
    bez záruky nijakého druhu, vyjadrený alebo zahrnutý, vrátane, ale nie
    limitovaný na, zahrnuté záruky obchodovateµnosti a vhodnosti pre
    príslu¹ný úèel alebo záruky neporu¹ovania.
   </simpara>
  </section>


  <section id="opl.modified.works">
   <title>IV. PO®IADAVKY NA MODIFIKOVANÉ PRÁCE</title>
   <para>
    V¹etky modifikované verzie dokumentu pokryté touto licenciou, vrátane
    prekladov, zbierok, kompilácií a èiastoèných dokumentov, musia spåòa»
    následujúce po¾iadavky:
   </para>
   <para>
    <orderedlist>
     <listitem>
      <simpara>
       Modifikovaná verzia ako taká musí by» oznaèená.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Osoby vykonávajúce modifikácie musia by» uvedené
       a modifikácie zdátumované.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Poïakovanie pôvodného autora a vydávateµa, ak je to mo¾né, musia
       by» uchované  podµa normálnych praktík akademickej citácie.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Umiestnenie pôvodného nemodifikovaného dokumentu musí by» uvedené.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Meno(-á) pôvodného(-ých) autora(-ov) sa nemo¾u pou¾i» na uistenie
       alebo zahrnutie schválenia výsledného dokumentu bez povolenia
       pôvodného(-ých) autora(-ov).
      </simpara>
     </listitem>
    </orderedlist>
   </para>
  </section>

  <section id="opl.good-practice">
   <title>V. VHODNÉ DOPORUÈENIA</title>
   <simpara>
    Okrem po¾iadaviek tejto licencie sa silne doporuèuje a vy¾aduje od
    redistribútorov, ¾e:
   </simpara>
   <para>
    <orderedlist>
     <listitem>
      <simpara>
       Ak distribuujete práce Open Publication ako tvrdé kópie alebo CD-ROM,
       emailom poskytnite notifikáciu autorom o svojom zámere redistribúcie
       najmenej tridsa» dní pred uvedením manuskriptu alebo média, aby ste takò
       dali autorom èas na poskytnutie aktualizovaných dokumentov. Táto
       notifikácia by mala popisova» zmeny, ak nejaké sú, vykonané na dokumente.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       V¹etky podstatné zmeny (vrátane odstránení) by mali by» buï
       jasne oznaèené v dokumente alebo inak popísané v prílohe
       dokumentu.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Nakoniec, èo nie je mandatóriom tejto licencie, pova¾uje sa za dobrú
       formu ponúknu» voµnú kópiu v¹etkých tvrdých kópií a CD-ROM vyjadrení
       práce licencovanej Open Publication jej autorovi(-om).
      </simpara>
     </listitem>
    </orderedlist>
   </para>
  </section>

  <section id="opl.options">
   <title>VI. LICENÈNÉ VO¥BY</title>
   <simpara>
    Autor(i) a/alebo vydávateµ dokumentu s licenciou Open Publication
    mô¾e zvoli» urèité voµby pridaním jazyka do referencie alebo
    kópie licencie. Tieto voµby sa pova¾ujú za èas» licenènej in¹tancie
    a musia by» zahrnuté s licenciou (alebo jej referenèné
    zaèlenenie) v odvodených prácach.
   </simpara>
   <simpara>
    A. Zabráni» distribúcii podstatne modifikovaných verzií bez explicitného
    povolenia autora(-ov). "Podstatná modifikácia" sa definuje ako
    zmena sémantického obsahu dokumentu a vyníma èisté zmeny vo formáte
    alebo typografické opravy.
   </simpara>
   <simpara>
    Aby sa tak uskutoènilo, pridajte frázu `Distribúcia podstatne modifikovaných
    verzií tohto dokumentu je zakázané bez explicitného povolenia dr¾iteµa
    autorských práv.' do licenènej referencie alebo kópie.
   </simpara>
   <simpara>
    B. Zabránenie publikácii tejto práce alebo odvodených prác v celku alebo
    po èastiach v ¹tandardnej (papierovej) kni¾nej forme pre komerèné úèely je
    zakázané pokiaµ nie je udelené povolenie od vlastníka autorských práv.
   </simpara>
   <simpara>
    Aby sa tak uskutoènilo, pridajte frázu 'Distribúcia práce alebo odvodenia
    práce v akejkoµvek ¹tandardnej (papierovej) kni¾nej forme je zakázané pokiaµr
    nie je udelené povolenie od vlastníka autorských práv.' do licenènej
    referencie alebo kópie.
   </simpara>
  </section>
</appendix>

http://cvs.php.net/co.php/phpdoc-sk/appendices/migration5.xml?r=1.1&p=1
Index: phpdoc-sk/appendices/migration5.xml
+++ phpdoc-sk/appendices/migration5.xml
<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.4 Maintainer: joseph Status: ready -->
 <appendix id="migration5">
  <title>Migrácia z PHP 4 na PHP 5</title>

  <section id='migration5.changes'>
   <title>Èo sa zmenilo v PHP 5</title>
   <para>
    PHP 5 a integrovaný Zend Engine 2 významne zlep¹ili výkon
    a schopnosti PHP, ale významná pozornos» sa venovala èo najmen¹iemu
    poru¹eniu existujúceho kódu. Tak¾e migrácia vá¹ho kódu z PHP 4 na 5
    by malo by» µahké. Väè¹ina existujúceho PHP 4 kódu by mala by» pripravená
    na beh bez zmien, ale stále by ste mali vedie» o <link
    linkend="migration5.incompatible">pár odli¹nostiach</link> a
    postara» sa o testovanie vá¹ho kódu pred prepnutím verzií v produkènom
    prostredí.
   </para>
  </section>

  <section id="migration5.incompatible">
   <title>Spätné Nekompaktibilné Zmeny</title>
   <para>
    I keï väè¹ina existujúceho PHP 4 kódu by mala fungova» bez zmien, mali by
    venova» pozornos» týmto spätným nekompaktibilným zmenám:
   </para>
   <itemizedlist>
    <listitem><simpara>
      <function>strrpos</function> a <function>strripos</function> teraz
      pou¾ívajú celý re»azec ako ihlu.
    </simpara></listitem>
    <listitem><simpara>
      Nelegálne pou¾itie offsetov re»azca spôsobuje <constant>E_ERROR</constant> namesto
      <constant>E_WARNING</constant>.
    </simpara></listitem>
    <listitem><simpara>
      <function>array_merge</function> bola zmenená na akceptovanie iba polí. 
      Ak sa vlo¾í premenná, ktorá nie je typu array, <constant>E_WARNING</constant> 
      sa objaví pre ka¾dý taký parameter. Buïte opatrný preto¾e vá¹ kód mô¾e
      zaèa» emitova» <constant>E_WARNING</constant> z èista jasna.
    </simpara></listitem>
    <listitem><simpara>
     PATH_TRANSLATED premenná servera u¾ nie je implicitne nastavená pod
     Apache2 SAPI na rozdiel od situácie v PHP 4, kde je nastavená na
     rovnakú hodnotu ako SCRIPT_FILENAME premenná servera, keï nie je
     obsadená Apacheom. Táto zmena sa urobila na vyhovenie s <ulink
      url="&url.cgispecs;">CGI ¹pecifikáciou</ulink>. Prosím, pozrite si <ulink
      url="&url.php.bugs;23610">bug #23610</ulink> pre ïal¹ie informácie.
    </simpara></listitem>
    <listitem><simpara>
     Kon¹tanta <constant>T_ML_CONSTANT</constant> u¾ nie je definovaná
     roz¹írením <link linkend="ref.tokenizer">Tokenizer</link>. Ak je
     error_reporting nastanený na <constant>E_ALL</constant>, PHP vygeneruje
     oznam. Namiesto <constant>T_ML_CONSTANT</constant> pre /* */ sa pou¾ije
     kon¹tanta <constant>T_COMMENT</constant>, i keï obe // a /* */
     sa berú ako kon¹tanta <constant>T_COMMENT</constant>. Av¹ak PHPDoc
     ¹týlové komentáre /** */ , ktoré poèínajúc PHP5 sú analyzované PHP-èkom,
     sú rozpoznávané ako <constant>T_DOC_COMMENT</constant>.
    </simpara></listitem>
    <listitem><simpara>
     $_SERVER by mala by» obsadená s argc a argv ak variables_order
     zahàòa "S".  Ak ste ¹pecificky nakonfigurovali svoj systém na
     nevytváranie $_SERVER, potom samozrejme by tam nemala by». Zmena bola
     v¾dy urobi» z argc a argv premennú v  CLI verziu bez ohµadu na
     nastavenie variables_order.  CLI verzia bude v¾dy obsadzova»
     globálne premenné $argc a $argv.
    </simpara></listitem>
    <listitem><simpara>
      Triedy sa musia pred pou¾itím deklarova».
    </simpara></listitem>
   </itemizedlist>
  </section>

  <section id="migration5.configuration">
   <title>Migrujúce Konfiguraèné Súbory</title>
   <para>
    Nakoµko si ISAPI moduly zmenili svoje názvy, z php4xxx na php5xxx,
    musíte urobi» nejaké zmeny v konfiguraèných súboroch. Tie¾ nastali
    zmeny v názvoch súborov CLI a CGI. Prosím, pozrite si zodpovedajúcu
    sekciu pre viac informácii.
   </para>
   <para>
    Migrovanie Apache konfigurácie je extrémne jednoduché. Prozri príklad
    uvedený ni¾¹ie na kontrolu zmien, ktoré musíte urobi»:
    <informalexample>
     <programlisting role="apache-conf">
<![CDATA[
# zamente tento riadok: 
LoadModule php4_module /php/sapi/php4apache2.dll

# za tento:
LoadModule php5_module /php/php5apache2.dll
]]>
     </programlisting>
    </informalexample>
   </para>
   <para>
    Ak na vá¹om webserveri be¾í PHP v CGI móde, mali by ste si v¹imnú», ¾e
    si CGI verzia zmenila svoj názov z php.exe na php-cgi.exe.
    V Apache by ste mali urobi» nieèo takéto:
    <informalexample>
     <programlisting role="apache-conf">
<![CDATA[
# zamente tento riadok:    
Action application/x-httpd-php "/php/php.exe" 

# za tento:
Action application/x-httpd-php "/php/php-cgi.exe" 
]]>
     </programlisting>
    </informalexample>
   </para>
   <para>
    V iných webserveroch musíte zmeni» názvy súborov buï v CGI alebo ISAPI
    moduloch.
   </para>
  </section>

 </appendix>


<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->