On Nov 4, 2008, at 11:29 AM, Brice Figureau wrote:
>
> That might be the best solution. I wasn't keen about using puppet.conf
> for puppetdoc (it wasn't using it before my patch), as it would tie
> documentation generation to a specific installation. And there is the
> problem of environments, too.
>
> But, since you can override puppet.conf directives with the command
> line
> arguments, I think that will works.
>
> OK, to summarize:
>
> By default puppetdoc uses the default puppet.conf, except if overriden
> with --configdir or --config (default puppet* behavior).
>
> If --modulepath or --manifests are provided, they override puppet.conf
> defaults.
>
> Now, the behavior is to generate documentation for both site manifests
> _and_ modulepath (if not empty). If modulepath is overriden and
> defaults
> to /dev/null or an inexistant path, don't produce doc for modules.
> Same
> for manifests.
>
> If --mode is rdoc and path are passed in ARGV, then the additionnal
> path
> are scanned for global manifests. If those path overlaps with any
> configured modulepaths, then we exit with an error.
>
> If --mode is not rdoc and filenames are passed in ARGV, then perform a
> straight documentation extract (no fancy formatting and so) on stdout.
>
> Luke, do you agree with this?
> Did I forgot anything?
> If not then I'll follow this specs.
Yes, this seems like a good idea.
--
If you would be a real seeker after truth, it is necessary that at
least once in your life you doubt, as far as possible, all things.
-- Rene Descartes
---------------------------------------------------------------------
Luke Kanies | http://reductivelabs.com | http://madstop.com
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"Puppet Developers" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/puppet-dev?hl=en
-~----------~----~----~----~------~----~------~--~---
