Решение сообщений об ошибках от PHPdoc - PullRequest
Новая
       12

Решение сообщений об ошибках от PHPdoc

1 голос
/ 30 августа 2009

Как вы можете решить следующие сообщения об ошибках, выданные PHPdoc?

Я запускаю madedoc.sh с помощью следующей команды

Команда 

sudo ./makedoc.sh

Я получаю

Сообщения об ошибках 

PHP Version 5.2.6-3ubuntu4.2
phpDocumentor version 1.4.2

Parsing configuration file phpDocumentor.ini...
   (found in /usr/share/php/data/PhpDocumentor/)...

done
Maximum memory usage set at 256M after considering php.ini...
using tokenizer Parser

        ERROR: Converter PDFSmartyConverter specified by --output command-line option is not a class

        ERROR: No Converters have been specified by --output command-line option

        ERROR: No Converters have been specified by --output command-line option

Пример комментариев, которые я пытаюсь сгенерировать 

/** Create HTML for tags
 * @param string @tags
 */
function create_tags_at_question ( $tags ) {
    echo ("<label for='tags'>Tags</label>"
        . "<input name='question[tags]' type='text' cols='92' class='tags' id='required'"
        . " value='" . $tags . "' />"
    );
}

Мой makedoc.sh для PHPdoc 

#!/bin/bash
#/**
#  * title of generated documentation, default is 'Generated Documentation'
#  *
#  * @var               string TITLE
#  */
TITLE="komponentit"

#/**
#  * name to use for the default package. If not specified, uses 'default'
#  *
#  * @var               string PACKAGES
#  */
PACKAGES="default"

#/**
#  * name of a directory(s) to parse directory1,directory2
#  * $PWD is the directory where makedoc.sh
#  *
#  * @var               string PATH_PROJECT
#  */
PATH_PROJECT=$PWD:$PWD/handlers/:$PWD/handlers/searches/

#/**
#  * path of PHPDoc executable
#  *
#  * @var               string PATH_PHPDOC
#  */
PATH_PHPDOC=/usr/bin/phpdoc

#/**
#  * where documentation will be put
#  *
#  * @var               string PATH_DOCS
#  */
PATH_DOCS=$PWD/docs/

#/**
#  * what outputformat to use (html/pdf)
#  *
#  * @var               string OUTPUTFORMAT
#  */
OUTPUTFORMAT=pdf

#/**
#  * converter to be used
#  *
#  * @var               string CONVERTER
#  */
CONVERTER=Smarty

#/**
#  * template to use
#  *
#  * @var               string TEMPLATE
#  */
TEMPLATE=default

#/**
#  * parse elements marked as private
#  *
#  * @var               bool (on/off)           PRIVATE
#  */
PRIVATE=off

# make documentation
"$PATH_PHPDOC" -d "$PATH_PROJECT" -t "$PATH_DOCS" -ti "$TITLE" -dn $PACKAGES \
-o $OUTPUTFORMAT:$CONVERTER:$TEMPLATE -pp $PRIVATE

1 Ответ

2 голосов
/ 30 августа 2009

Терпите меня ... Я не знаю PHPdoc, так что я немного догадываюсь здесь, пока не прибудет кавалерия.

Что-то про 

"$PATH_PHPDOC" -d "$PATH_PROJECT" -t "$PATH_DOCS" -ti "$TITLE" -dn $PACKAGES \
-o $OUTPUTFORMAT:$CONVERTER:$TEMPLATE -pp $PRIVATE

делает токенизатор Parser несчастным. Что-то в синтаксисе не правильно.

Все три ошибки относятся к этой строке makedoc.sh

  • - вывод, вероятно, является длинной формой -o, которую вы использовали в makedoc.sh
  • PdfSmartConverter в первой ошибке, кажется, состоит из нескольких переменных в makedoc.sh, запускаемых вместе. Вам нужны пробелы или какой-либо другой разделитель?
  • тебе нужно больше ""
  • достаточно 'pdf' спецификатора формата вывода

Как я уже сказал, я просто догадываюсь - но, возможно, это даст вам некоторые идеи.

Теперь ... где эта кавалерия?

...