Added more PHPDoc stuff

libraries/ActionCode.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the action code handling class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 /**

libraries/BBcode.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the BBcode handler.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 use JBBCode\Parser;

libraries/BBcodeDefinitions/Align.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the text alignment bbcode class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\BBcodeDefinitions;
 
 use JBBCode\Parser;

libraries/BBcodeDefinitions/Code.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the code format bbcode class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\BBcodeDefinitions;
 
 use JBBCode\Parser;

libraries/BBcodeDefinitions/Lists.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the list bbcode class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\BBcodeDefinitions;
 
 use JBBCode\Parser;

libraries/BBcodeDefinitions/Size.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the font size bbcode class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\BBcodeDefinitions;
 
 use JBBCode\Parser;

libraries/BBcodeDefinitions/User.php

@@ -1,6 +1,8 @@
 <?php
-/*
- * User bbcode
+/**
+ * Holds the username linking bbcode class.
+ * 
+ * @package Sakura
  */
 
 namespace Sakura\BBcodeDefinitions;
@@ -9,8 +11,17 @@ use JBBCode\Parser;
 use JBBCode\CodeDefinition;
 use JBBCode\ElementNode;
 
+/**
+ * Username BBcode for JBBCode.
+ * 
+ * @package Sakura
+ * @author Julian van de Groep <me@flash.moe>
+ */
 class User extends CodeDefinition
 {
+    /**
+     * Constructor.
+     */
     public function __construct()
     {
         parent::__construct();
@@ -19,6 +30,13 @@ class User extends CodeDefinition
         $this->setParseContent(false);
     }
 
+    /**
+     * Compiles the user bbcode to HTML
+     * 
+     * @param ElementNode $el The JBBCode element node.
+     * 
+     * @return string The compiled HTML.
+     */
     public function asHtml(ElementNode $el)
     {
         $content = "";

libraries/BBcodeDefinitions/YouTube.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the YouTube embed bbcode class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\BBcodeDefinitions;
 
 use JBBCode\Parser;

libraries/Bans.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the ban manager.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 /**

libraries/CSRF.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the CSRF token handler.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 use Sakura\Hashing;

libraries/Comments.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the holds the comment handler class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 /**

libraries/Config.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the configuration manager.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 /**

libraries/Console/Application.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the console application meta.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\Console;
 
 /**

libraries/Controllers/Forum.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the forum pages controllers.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\Controllers;
 
 use Sakura\Config;

libraries/Controllers/Meta.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the meta page controllers.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\Controllers;
 
 use Sakura\Config;

libraries/DBWrapper/mysql.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the MySQL/PDO wrapper.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\DBWrapper;
 
 use PDO;

libraries/Database.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the database wrapper interfacer.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 /**

libraries/File.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the file server.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 use finfo;

libraries/Forum/Forum.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the forum object class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\Forum;
 
 use Sakura\Database;
@@ -157,7 +163,11 @@ class Forum
         return $raw ? $perm : $this->_permissions->check($flag, $perm);
     }
 
-    // Subforums
+    /**
+     * Gets all subforums of this forum.
+     * 
+     * @return array Array containing forum objects.
+     */
     public function forums()
     {
         // Check if _forums is populated

libraries/Forum/Post.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the post object class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\Forum;
 
 use Sakura\Utils;

libraries/Forum/Thread.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the thread object class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\Forum;
 
 use Sakura\Database;

libraries/Hashing.php

@@ -1,5 +1,5 @@
 <?php
-/*
+/**
  * Password Hashing With PBKDF2 (https://defuse.ca/php-pbkdf2.htm).
  * Copyright (c) 2013, Taylor Hornby
  * All rights reserved.
@@ -25,6 +25,8 @@
  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
+ * 
+ * @package Sakura
  */
 
 namespace Sakura;

libraries/News.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the news handler.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 /**

libraries/Payments.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the payments handler.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 use \PayPal\Api\Amount;

libraries/Perms.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the global permissions handler.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 /**

libraries/Perms/Forum.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the forum permission flags.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\Perms;
 
 /**

libraries/Perms/Manage.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the site management permission flags.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\Perms;
 
 /**

libraries/Perms/Site.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the global site permission flags.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura\Perms;
 
 /**

libraries/Rank.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the rank object class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 use Sakura\Perms;

libraries/Router.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the router class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 use Phroute\Phroute\RouteCollector;

libraries/Session.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the session handler.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 /**

libraries/Template.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the templating engine class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 use Twig_Environment;

libraries/Trick.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the extension manager.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 /**

libraries/Urls.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the url generation class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 /**

libraries/User.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds the user object class.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 use Sakura\Perms;

libraries/Users.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds various functions to interface with users.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 use Sakura\Perms\Site;

libraries/Utils.php

@@ -1,4 +1,10 @@
 <?php
+/**
+ * Holds various utility functions.
+ * 
+ * @package Sakura
+ */
+
 namespace Sakura;
 
 use PHPMailer;

libraries/Whois.php

@@ -1,5 +1,5 @@
 <?php
-/*
+/**
  * Whois in PHP (featuring a very original name), adjusted for Sakura
  * By Flashwave <http://flash.moe>
  * Released under the MIT-License
@@ -25,6 +25,8 @@
  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  * SOFTWARE.
+ * 
+ * @package Sakura
  */
 
 namespace Sakura;