Improve phpDoc class docs

lib/PicoTwigExtension.php

@@ -130,6 +130,8 @@ class PicoTwigExtension extends Twig_Extension
      *     $item['foo']['bar'] values)
      *
      * @return array mapped values
+     *
+     * @throws Twig_Error_Runtime
      */
     public function mapFilter($var, $mapKeyPath)
     {
@@ -170,6 +172,8 @@ class PicoTwigExtension extends Twig_Extension
      *     these items
      *
      * @return array sorted array
+     *
+     * @throws Twig_Error_Runtime
      */
     public function sortByFilter($var, $sortKeyPath, $fallback = 'bottom')
     {

plugins/DummyPlugin.php

@@ -119,7 +119,7 @@ class DummyPlugin extends AbstractPicoPlugin
      * @see Pico::loadTheme()
      * @see DummyPlugin::onThemeLoaded()
      *
-     * @param string $theme name of current theme
+     * @param string &$theme name of current theme
      */
     public function onThemeLoading(&$theme)
     {
@@ -135,7 +135,7 @@ class DummyPlugin extends AbstractPicoPlugin
      *
      * @param string $theme           name of current theme
      * @param int    $themeApiVersion API version of the theme
-     * @param array  $themeConfig     config array of the theme
+     * @param array  &$themeConfig    config array of the theme
      */
     public function onThemeLoaded($theme, $themeApiVersion, array &$themeConfig)
     {