Merged many language files from HEAD

lang/tl/docs/coding.html

@@ -1,11 +1,13 @@
-<html>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml">
 <head>
 <title>Moodle Doks: Alituntunin sa Pagcode</title>
 <link rel="stylesheet" href="docstyles.css" type="TEXT/CSS">
 <meta http-equiv="Content-Type" content="text/html;
-charset=iso-8859-15">
+charset=iso-8859-15" />
 </head>
-<body bgcolor="#FFFFFF">
+<body>
 <h1>Mga Alituntunin sa Pagcode ng Moodle</h1>
 <p class="normaltext">
 Alinmang proyekto na pinagtutulungtulungan ng maraming tao ay
@@ -23,7 +25,7 @@ na sumunod sa mga istandard na ito hangga't maaari.
 <h2>Pangkalahatang Patakaran</h2>
 
 <ol class="normaltext">
-  <li class="spaced">Dapat gamitin ng lahat ng code file ang extensiong
+  <li class="spaced">Dapat gamitin ng lahat ng code file ang ekstensiyong
 .php.</li>
   <li class="spaced">Dapat gamitin ng lahat ng template file ang
 extensiong .html.</li>
@@ -86,8 +88,8 @@ kailangan ding baguhin upang tumuro sa mga pinakabagong bersiyon. </li>
     </p>
 </li>
 
-  <li class="spaced">Awtomatikong nilalagyan ng magic_quotes ang
-pumpasok na datos mula sa browser (na ipinadala sa pamamagitan ng GET o
+  <li class="spaced">Awtomatikong nilalagyan ng magic_quotes (anuman ang kaayusan ng PHP) ang
+pumapasok na datos mula sa browser (na ipinadala sa pamamagitan ng GET o
 POST) upang ligtas na maipasok ito nang diretso sa database.  Lahat ng
 iba pang raw na datos (mula sa files, o mula sa mga database) ay
 kailangang lagyan ng escape sa pamamagitan ng <font
@@ -142,7 +144,7 @@ kaya pakisunod naman.
   <li class="spaced">Dapat ay simpleng Ingles na salita na nasa
 lowercase ang gagamitin sa mga <strong>pangalan ng function</strong>,
 at dapat itong magsimula sa pangalan ng modyul para maiwasan ang
-pagkakagulo ng mga modyul.  Dapat ay palaging may sensible na default
+pagkakagulo ng mga modyul.  Dapat ay palaging may makatwirang default
 ang mga parameter, kung maaari.  Tandaan na walang space sa pagitan ng
 pangalan ng function at ng sumusunod na (bracket).
 <br />
@@ -185,17 +187,35 @@ pamamagitan ng iisang pansipi hangga't maaari, para mapabilis ito.
       $var = 'a very, very long string with a '.$single.' variable in it';<br />
       $var = &quot;some $text with $many variables $within it&quot;; </font></p>
   </li>
-  <li class="spaced">Dapat gumamit ng dalawa o tatlong slash ang mga 
-<strong>comment</strong> at ihanay ito nang maayos sa code.
-    <p class="examplecode"><font color="#006600">function </font><font color="#0000BB">forum_get_ratings_mean</font><font color="#007700">(</font><font color="#0000BB">$postid</font><font color="#007700">, 
+
+  <li class="spaced">Dapat magdagdag ng mga 
+<strong>comment</strong> hangga't maaari, upang maipaliwanag ang daloy at layunin ng mga function at variable.
+
+ <ul>
+     <li>Ang bawat function (at class) ay dapat gamitan ng popular na
+         <a target="_blank" href="http://www.phpdoc.org/">phpDoc format</a>.
+          Pinapahintulutan nito ang awtomatikong paglikha ng dokumentasyon ng code.</li>
+     <li>Ang mga inline na comment ay dapat gamitan ng estilong // , na ihinanay nang maayos upang umangkop ito sa code at umayon ito sa linya nito.
+</li>
+     </ul>
+  
+  
+   <p class="examplecode"><font color="#FF8000">
+/**<br />
+ * The description should be first, with asterisks laid out exactly<br />
+ * like this example.  If you want to refer to a another function,<br />
+ * do it like this: {@link clean_param()}.  Then, add descriptions <br />
+ * for each parameter as follows.<br />
+ *<br />
+ * @param int    $postid The PHP type is followed by the variable name<br />
+ * @param array  $scale The PHP type is followed by the variable name<br />
+ * @param array  $ratings The PHP type is followed by the variable name<br />
+ * @return mixed<br />
+ */</font><br />
+<font color="#006600">function </font><font color="#0000BB">forum_get_ratings_mean</font><font color="#007700">(</font><font color="#0000BB">$postid</font><font color="#007700">, 
       </font><font color="#0000BB">$scale</font><font color="#007700">, </font><font color="#0000BB">$ratings</font><font color="#007700">=</font><font color="#0000BB">NULL</font><font color="#007700">) 
-      {<br />
-      </font><font color="#FF8000">/// Return the mean rating of a post given 
-      to the current user by others.<br />
-      /// Scale is an array of possible ratings in the scale<br />
-      /// Ratings is an optional simple array of actual ratings (just integers)<br />
-      <br />
-      &nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#007700">if (!</font><font color="#0000BB">$ratings</font><font color="#007700">) 
+      {<br /></font>
+      &nbsp;&nbsp;&nbsp;&nbsp;<font color="#007700">if (!</font><font color="#0000BB">$ratings</font><font color="#007700">) 
       {<br />
       &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#0000BB">$ratings 
       </font><font color="#007700">= array(); &nbsp;&nbsp;&nbsp;&nbsp;</font><font color="#FF8000">// 
@@ -209,8 +229,9 @@ pamamagitan ng iisang pansipi hangga't maaari, para mapabilis ito.
       &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;foreach 
       (</font><font color="#0000BB">$rates </font><font color="#007700">as </font><font color="#0000BB">$rate</font><font color="#007700">) 
       {</font> <br />
-      ....atbp </p>
+      ....etc </p>
   </li>
+
   <li class="spaced">Dapat gumamit ng maraming <strong>space</strong> -
 huwag kang matakot na medyo magkalayo-layo ang mga bagay para mas
 malinaw itong basahin.  Sa pangkalahatan, dapat magkaroon ng isang space
@@ -241,7 +262,7 @@ sa pagitan ng mga bracket at variable o function:
   </li>
 </ol>
 <p>&nbsp;</p>
-<h2>Mga structure ng database</h2>
+<h2>Mga balangkas ng database</h2>
 <ol class="normaltext">
   <li class="spaced">Dapat magka-auto-incrementing <strong>id</strong>
 field (INT10) ang bawat table bilang primary na index.
@@ -259,7 +280,7 @@ ang bawat instance</li>
 ng modyul</li>
     </ul>
   </li>
-  <li class="spaced">Ang iba pang tabale na kaugnay ng isang modyul na
+  <li class="spaced">Ang iba pang table na kaugnay ng isang modyul na
 naglalaman ng impormasyon hinggil sa mga 'things' ay dapat pangalanan ng 
 <strong>widget_things</strong> (pansinin ang plural).
 </li>
@@ -285,8 +306,9 @@ kasalukuyang timestamp na nakuha sa pamamgitan ng PHP
 
 </ol>
 <hr />
-<p align="CENTER"><font size="1"><a href="."
-target="_top">Dokumentasyon ng Moodle</a></font></p>
-<p align="CENTER"><font size="1">Bersiyon: $Id$</font></p>
+<p align="CENTER"><font size="1"><a href="." target="_top">
+Dokumentasyon ng Moodle</a></font></p>
+<p align="center"><font size="1">Version: $Id$</font></p>
+
 </body>
-</html>
+</html>