git://git.onelab.eu
/
plcapi.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
wip revive and split off doc generatin toolchain
[plcapi.git]
/
pakefile.php
diff --git
a/pakefile.php
b/pakefile.php
index
4bca828
..
956cc66
100644
(file)
--- a/
pakefile.php
+++ b/
pakefile.php
@@
-3,7
+3,7
@@
* Makefile for phpxmlrpc library.
* To be used with the Pake tool: https://github.com/indeyets/pake/wiki
*
* Makefile for phpxmlrpc library.
* To be used with the Pake tool: https://github.com/indeyets/pake/wiki
*
- * @copyright (c) 2015 G. Giunta
+ * @copyright (c) 2015
-2021
G. Giunta
*
* @todo !important allow user to specify location of docbook xslt instead of the one installed via composer
*/
*
* @todo !important allow user to specify location of docbook xslt instead of the one installed via composer
*/
@@
-42,6
+42,11
@@
class Builder
return self::buildDir().'/workspace';
}
return self::buildDir().'/workspace';
}
+ public static function toolsDir()
+ {
+ return self::buildDir().'/tools';
+ }
+
/// most likely things will break if this one is moved outside of BuildDir
public static function distDir()
{
/// most likely things will break if this one is moved outside of BuildDir
public static function distDir()
{
@@
-104,7
+109,6
@@
class Builder
*/
public static function applyXslt($inFile, $xssFile, $outFileOrDir)
{
*/
public static function applyXslt($inFile, $xssFile, $outFileOrDir)
{
-
if (!file_exists($inFile)) {
throw new \Exception("File $inFile cannot be found");
}
if (!file_exists($inFile)) {
throw new \Exception("File $inFile cannot be found");
}
@@
-256,9
+260,11
@@
function run_doc($task=null, $args=array(), $cliOpts=array())
// API docs
// API docs
+ /// @todo sami is anbandonware, whereas phpdocumentor is not. switch back to phpdocumentor
+
// from phpdoc comments using phpdocumentor
//$cmd = Builder::tool('php');
// from phpdoc comments using phpdocumentor
//$cmd = Builder::tool('php');
- //pake_sh("$cmd
vendor/phpdocumentor/phpdocument
or/bin/phpdoc run -d ".Builder::workspaceDir().'/src'." -t ".Builder::workspaceDir().'/doc/api --title PHP-XMLRPC');
+ //pake_sh("$cmd
" . Builder::toolsDir(). "/vend
or/bin/phpdoc run -d ".Builder::workspaceDir().'/src'." -t ".Builder::workspaceDir().'/doc/api --title PHP-XMLRPC');
// from phpdoc comments using Sami
$samiConfig = <<<EOT
// from phpdoc comments using Sami
$samiConfig = <<<EOT
@@
-278,7
+284,7
@@
function run_doc($task=null, $args=array(), $cliOpts=array())
EOT;
file_put_contents('build/sami_config.php', $samiConfig);
$cmd = Builder::tool('php');
EOT;
file_put_contents('build/sami_config.php', $samiConfig);
$cmd = Builder::tool('php');
- pake_sh("$cmd
vendor/sami/sami
/sami.php update -vvv build/sami_config.php");
+ pake_sh("$cmd
" . Builder::toolsDir(). "/vendor/bin
/sami.php update -vvv build/sami_config.php");
// User Manual
// User Manual