Changeset 93013 in spip-zone


Ignore:
Timestamp:
Nov 19, 2015, 6:51:05 PM (4 years ago)
Author:
marcimat@…
Message:

Une option --force sur l'aide à la génération des docs de plugin, pour générer la doc même si le plugin n'a pas été mis à jour.

Location:
_galaxie_/code.spip.net/autodoc/trunk
Files:
3 edited

Legend:

Unmodified
Added
Removed
  • _galaxie_/code.spip.net/autodoc/trunk/installation.md

    r87569 r93013  
    206206        autodoc/bin/autodoc_helper from:file svn://zone.spip.org/spip-zone/autodoc.txt
    207207
    208 
     208Les documentations sont générées chacunes dans leur répertoire nommée par le préfixe du plugin
     209et un sommaire est généré dans le répertoire de sortie (work/output par défaut) et les plugins
     210générés sont dans work/output/$prefixe.
     211
     212Si le plugin n'a pas eu de commit depuis la dernière génération, la documentation
     213n'est pas recrée.
     214
     215On peut forcer :
     216
     217- le répertoire de sortie : `--sorties=chemin`
     218- le plugin généré (via son préfixe) : `--prefixe=saisies`
     219- ou forcer la génération de la documentation, même si ce n'est pas nécessaire : `--force`
  • _galaxie_/code.spip.net/autodoc/trunk/src/autodoc/Helpers/Command/FromFile.php

    r92943 r93013  
    3939            ->addOption('avec_boussole_spip', null, InputOption::VALUE_NONE, "Intègre le JS de la boussole SPIP en entête topnav.")
    4040            ->addOption('prefixe', 'p', InputOption::VALUE_OPTIONAL, "Préfixe de plugin. Lui seul sera actualisé si présent.")
     41            ->addOption('force', '', InputOption::VALUE_NONE, "Force la génération de la documentation même si le plugin n'a eu de modifications depuis la fois précédente.")
    4142            ;
    4243    }
  • _galaxie_/code.spip.net/autodoc/trunk/src/autodoc/Helpers/Generator.php

    r92999 r93013  
    288288        if ($revision_nouvelle <= $revision_actuelle) {
    289289            $this->output->writeln("* Documentation déjà à jour.");
    290             return null;
     290            // sauf si on le force explicitement
     291            if (!$this->getOption('force')) {
     292                return null;
     293            }
    291294        }
    292295
Note: See TracChangeset for help on using the changeset viewer.