Please go back to your regularly scheduled programs. -- Men never do evil so completely and cheerfully as when they do it from a religious conviction. --Blaise Pascal --------------------------------------------------------------------- Luke Kanies | http://reductivelabs.com | http://madstop.com
Hi, Am 13.02.2008 um 13:57 schrieb Luke Kanies:> Please go back to your regularly scheduled programs.Thanks a lot. Quite hard to try to write your first puppetmaster type (my first ruby code, for that matter) when the site with the documentation is down :-) Felix Schäfer
On Feb 13, 2008, at 7:00 AM, Felix Schäfer wrote:> Hi, > > Am 13.02.2008 um 13:57 schrieb Luke Kanies: > >> Please go back to your regularly scheduled programs. > > Thanks a lot. Quite hard to try to write your first puppetmaster type > (my first ruby code, for that matter) when the site with the > documentation is down :-)For the record, all of the reference documentation is available in RestructuredText via puppetdoc: puppetdoc -r type | less Or: puppetdoc -r type | rst2html > TypeReference.html -- The remarkable thing about Shakespeare is that he really is very good, in spite of all the people who say he is very good. -- Robert Graves --------------------------------------------------------------------- Luke Kanies | http://reductivelabs.com | http://madstop.com
Luke Kanies <luke@madstop.com> writes:> puppetdoc -r type | rst2html > TypeReference.htmlCool! On Debian unstable ''puppetdoc -a'' complains about ''docs'' and exits. This works instead: for i in `puppetdoc -l | awk ''{print $1}'' ` do echo $i; puppetdoc -r $i | rst2html > $i.html; echo done but complains about node_source (same error as ''puppetdoc -a'' gives) and report: node_source /usr/lib/ruby/1.8/puppet/reference/node_source.rb:4:in `generate'': undefined method `docs'' for ni l:NilClass (NoMethodError) from /usr/lib/ruby/1.8/puppet/util/reference.rb:153:in `to_rest'' from /usr/bin/puppetdoc:135:in `send'' from /usr/bin/puppetdoc:135 from /usr/bin/puppetdoc:131:in `each'' from /usr/bin/puppetdoc:131 report /usr/lib/ruby/1.8/puppet/util/subclass_loader.rb:64:in `method_missing'': undefined method `report docs'' for Puppet::Network::Handler::Report:Class (NoMethodError) from /usr/lib/ruby/1.8/puppet/reference/report.rb:2:in `generate'' from /usr/lib/ruby/1.8/puppet/util/reference.rb:153:in `to_rest'' from /usr/bin/puppetdoc:135:in `send'' from /usr/bin/puppetdoc:135 from /usr/bin/puppetdoc:131:in `each'' from /usr/bin/puppetdoc:131 Any idea why puppetdoc isn''t in the RH packages? Is it because of the comment at the top that says "Largely meant for internal Reductive Labs use"?
On Feb 13, 2008, at 8:04 AM, Mark Plaksin wrote:> Luke Kanies <luke@madstop.com> writes: > >> puppetdoc -r type | rst2html > TypeReference.html > > Cool! > > On Debian unstable ''puppetdoc -a'' complains about ''docs'' and exits.Hrm, this is clearly a bug. Damn. I''ll fix it.> > This works instead: > for i in `puppetdoc -l | awk ''{print $1}'' ` > do > echo $i; puppetdoc -r $i | rst2html > $i.html; echo > done > > but complains about node_source (same error as ''puppetdoc -a'' gives) > and > report: > [...] > Any idea why puppetdoc isn''t in the RH packages? Is it because of the > comment at the top that says "Largely meant for internal Reductive > Labs > use"?It''s actually not the case any more, so I think it''s not in the packages because no one''s really asked for it. BTW, if anyone can figure out why the completely generated doc can''t be turned into a pdf (via rst2tex and latex2pdf, i think), I''d appreciate it. -- The cure for writer''s cramp is writer''s block. -- Inigo DeLeon --------------------------------------------------------------------- Luke Kanies | http://reductivelabs.com | http://madstop.com
On Feb 13, 2008, at 8:42 AM, Luke Kanies wrote:> On Feb 13, 2008, at 8:04 AM, Mark Plaksin wrote: > >> Luke Kanies <luke@madstop.com> writes: >> >>> puppetdoc -r type | rst2html > TypeReference.html >> >> Cool! >> >> On Debian unstable ''puppetdoc -a'' complains about ''docs'' and exits. > > Hrm, this is clearly a bug. Damn. I''ll fix it.Fixed in 068b61e. The problem was that both the report and node_source references were made obsolete by the indirection reference. I''ve also added error handling (just a smidgeon) to puppetdoc. -- There are three kinds of death in this world. There''s heart death, there''s brain death, and there''s being off the network. -- Guy Almes --------------------------------------------------------------------- Luke Kanies | http://reductivelabs.com | http://madstop.com
Buy James Turnbull''s book :-) We received our copy on Monday...I haven''t had an opportunity to read it cover to cover, but it has already proven to be a great desk reference. Thanks James! ---- Original message ---->Date: Wed, 13 Feb 2008 14:00:17 +0100 >From: Felix Schäfer <schaefer@cypres-it.com> >Subject: Re: [Puppet-users] reductivelabs.com is back up >To: Puppet User Discussion <puppet-users@madstop.com> > >Hi, > >Am 13.02.2008 um 13:57 schrieb Luke Kanies: > >> Please go back to your regularly scheduled programs. > >Thanks a lot. Quite hard to try to write your firstpuppetmaster type>(my first ruby code, for that matter) when the site with the >documentation is down :-) > >Felix Schäfer >_______________________________________________ >Puppet-users mailing list >Puppet-users@madstop.com >https://mail.madstop.com/mailman/listinfo/puppet-users
Luke Kanies <luke@madstop.com> writes:>>> On Debian unstable ''puppetdoc -a'' complains about ''docs'' and exits. >> >> Hrm, this is clearly a bug. Damn. I''ll fix it. > > Fixed in 068b61e. The problem was that both the report and > node_source references were made obsolete by the indirection reference.Hmm. Do I have to do anything special to install and run from git? I removed all traces of Puppet, ran install.rb, and puppetdoc -a still gives the error about docs.
On Feb 15, 2008, at 7:45 AM, Mark Plaksin wrote:> Hmm. Do I have to do anything special to install and run from git? I > removed all traces of Puppet, ran install.rb, and puppetdoc -a still > gives the error about docs.Sorry; you need to run against the 0.24.x branch. Do ''git checkout 0.24.x''. We''re still trying to sort out how to manage multiple branches, and it looks like the current system isn''t exactly... obvious. -- Man is the only animal that can remain on friendly terms with the victims he intends to eat until he eats them. -- Samuel Butler (1835-1902) --------------------------------------------------------------------- Luke Kanies | http://reductivelabs.com | http://madstop.com
Luke Kanies <luke@madstop.com> writes:> On Feb 15, 2008, at 7:45 AM, Mark Plaksin wrote: > >> Hmm. Do I have to do anything special to install and run from git? I >> removed all traces of Puppet, ran install.rb, and puppetdoc -a still >> gives the error about docs. > > Sorry; you need to run against the 0.24.x branch. Do ''git checkout > 0.24.x''.''git checkout origin/0.24.x'' did the trick but I still get this: Could not generate reference node_source: can''t convert nil into String Could not generate reference report: undefined method `reportdocs'' for Puppet::Network::Handler::Report:Class And piping it through rst2html gives a fatal error because of these lines at the top: /usr/local/lib/site_ruby/1.8/puppet/util/reference.rb:153:in `+'' /usr/local/lib/site_ruby/1.8/puppet/util/reference.rb:153:in `to_rest'' bin/puppetdoc:137:in `send'' bin/puppetdoc:137 bin/puppetdoc:132:in `each'' bin/puppetdoc:132 /usr/local/lib/site_ruby/1.8/puppet/util/subclass_loader.rb:64:in `method_missing'' /usr/local/lib/site_ruby/1.8/puppet/reference/report.rb:2:in `generate'' /usr/local/lib/site_ruby/1.8/puppet/util/reference.rb:153:in `to_rest'' bin/puppetdoc:137:in `send'' bin/puppetdoc:137 bin/puppetdoc:132:in `each'' bin/puppetdoc:132 I ran my for loop again because it''s easier to read when there are separate files and still had problems with node_source and report--same errors as above. BTW, the DownloadingPuppet page says to use this to check out: git clone git://reductivelabs.com/git/puppet That fails but using http:// instead of git:// works. Should I update the Wiki or is git:// just temporarily broken? Or am I just crazy? :)
On Feb 15, 2008, at 11:33 AM, Mark Plaksin wrote:> Luke Kanies <luke@madstop.com> writes: > >> On Feb 15, 2008, at 7:45 AM, Mark Plaksin wrote: >> >>> Hmm. Do I have to do anything special to install and run from >>> git? I >>> removed all traces of Puppet, ran install.rb, and puppetdoc -a still >>> gives the error about docs. >> >> Sorry; you need to run against the 0.24.x branch. Do ''git checkout >> 0.24.x''. > > ''git checkout origin/0.24.x'' did the trick but I still get this: > > Could not generate reference node_source: can''t convert nil into > String > Could not generate reference report: undefined method `reportdocs'' > for Puppet::Network::Handler::Report:ClassThis is because it''s still using your installed files, not just the files in your git repo. Remove the installed files and it should work.> > And piping it through rst2html gives a fatal error because of these > lines at the top: > > /usr/local/lib/site_ruby/1.8/puppet/util/reference.rb:153:in `+'' > /usr/local/lib/site_ruby/1.8/puppet/util/reference.rb:153:in `to_rest'' > bin/puppetdoc:137:in `send'' > bin/puppetdoc:137 > bin/puppetdoc:132:in `each'' > bin/puppetdoc:132 > /usr/local/lib/site_ruby/1.8/puppet/util/subclass_loader.rb:64:in > `method_missing'' > /usr/local/lib/site_ruby/1.8/puppet/reference/report.rb:2:in > `generate'' > /usr/local/lib/site_ruby/1.8/puppet/util/reference.rb:153:in `to_rest'' > bin/puppetdoc:137:in `send'' > bin/puppetdoc:137 > bin/puppetdoc:132:in `each'' > bin/puppetdoc:132I assume this is because of the other failures you''re getting, and I notice it''s still using installed files, rather than the ones in your git repo.> > I ran my for loop again because it''s easier to read when there are > separate files and still had problems with node_source and report-- > same > errors as above. > > BTW, the DownloadingPuppet page says to use this to check out: > git clone git://reductivelabs.com/git/puppet > > That fails but using http:// instead of git:// works. Should I update > the Wiki or is git:// just temporarily broken? Or am I just crazy? :)Please fix the wiki. The correct git path is: git://reductivelabs.com/puppet Only one ''git'' in there. -- Ah, but I am more perceptive than most of the universe. Especially the parts of the universe that are vacuum. -- James Alan Gardner --------------------------------------------------------------------- Luke Kanies | http://reductivelabs.com | http://madstop.com
Luke Kanies <luke@madstop.com> writes:> This is because it''s still using your installed files, not just the > files in your git repo. Remove the installed files and it should work.Gah! I should have known that.>> That fails but using http:// instead of git:// works. Should I update >> the Wiki or is git:// just temporarily broken? Or am I just crazy? :) > > Please fix the wiki.Done.