mahara-contributors team mailing list archive

[Aaron Wells <1211621@xxxxxxxxxxxxxxxxxx>]

We use PHPDoc tags in Mahara. The main tool for converting those into
HTML these days is called phpDocumentor. There are a couple of tags for
linking around to other places in the code, including "@see" and "inlink
{@link}":

 -
http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.see.pkg.html

 -
http://manual.phpdoc.org/HTMLSmartyConverter/HandS/phpDocumentor/tutorial_tags.inlinelink.pkg.html

But, I don't think either of them will let you link to a non-PHP file
like LICENSE. So we may as well just have the @copyright line read like
this:

* @license http://www.gnu.org/copyleft/gpl.html GNU GPL version 3 or later
* @copyright For copyright information on Mahara, please see the LICENSE file distributed with this software.

-- 
You received this bug notification because you are a member of Mahara
Contributors, which is subscribed to Mahara.
Matching subscriptions: Subscription for all Mahara Contributors -- please ask on #mahara-dev or mahara.org forum before editing or unsubscribing it!
https://bugs.launchpad.net/bugs/1211621

Title:
  Correct license info in file headers

Status in Mahara ePortfolio:
  Confirmed

Bug description:
  The license info currently reads:

  ----
  * This program is free software: you can redistribute it and/or modify
   * it under the terms of the GNU General Public License as published by
   * the Free Software Foundation, either version 3 of the License, or
   * (at your option) any later version.
  ----

  To avoid any confusion, it should be corrected to read

  ----
  * This program is free software: you can redistribute it and/or modify
   * it under the terms of the GNU General Public License as published by
   * the Free Software Foundation, either version 3 or later of the License.
  -----

  The text appears as comment in probably pretty much every file in
  Mahara but also on the installation screen.

To manage notifications about this bug go to:
https://bugs.launchpad.net/mahara/+bug/1211621/+subscriptions