Re: NewHelpSystem & man pages

On Apr 24, 2009, at 21:02, ma...@macports.org wrote: Similarly, I've almost never looked at the chunked Guide. I load the single-page Guide, so that I can press Command-F, type my search string, press return, and find what I'm looking for. Which isn't to say we shouldn't have the chunked Guide;

Re: NewHelpSystem & man pages

>> This is also the reason why I am splitting this into multiple smaller >> man pages describing one command only. This makes it much easier to >> find >> what you are after than searching a long port(1). > >Just to talk about this one point for a moment, perl has its manpages >split up into seve

Re: NewHelpSystem & man pages

Simon Ruderich wrote: > The only problematic man page is portfile.7 as it is directly > wired into the guide. I would like to remove it (or generate it > through DocBook) and instead install the guide in > /opt/local/share/doc/port/ so the user can access it. Although we could install the guide lo

Re: NewHelpSystem & man pages

-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 On Fri, Apr 10, 2009 at 10:42:33PM +0200, Rainer Müller wrote: > For everyone who did not notice yet what this is about, I documented my > plans about a new help system based on AsciiDoc at > . Hi all, Fir

Re: NewHelpSystem & man pages

Ryan Schmidt wrote: > On Apr 14, 2009, at 15:52, Rainer Müller wrote: > >> I made a call for contributions on macports-users before about writing >> more helpful strings for the current implementation, but nobody >> seems to >> be interested. So why should I not be allowed to do something about

Re: NewHelpSystem & man pages

Forgot to send this to the list ... >AsciiDoc still gives control over DocBook and CSS. It is still possible >to change the XSL stylesheet converting the DocBook to HTML and the CSS >is in a separate file. It is even possible to add your own DocBook >elements if that would be necessary. Yes, but

Re: NewHelpSystem & man pages

On Apr 14, 2009, at 15:52, Rainer Müller wrote: I made a call for contributions on macports-users before about writing more helpful strings for the current implementation, but nobody seems to be interested. So why should I not be allowed to do something about it if nobody else cares? And as

Re: NewHelpSystem & man pages

ma...@macports.org wrote: > If you can produce better docs than what I've done it doesn't matter what > has already been done. I would naturally want to use the simplest method > that can produce acceptable output. If you can't with the method you have > proposed, then it doesn't matter if it has

Re: NewHelpSystem & man pages

I sent this to the wrong list address by mistake, so I'm sending it again. >I know that your long term goal was to integrate man pages and guide >together. But I didn't know yet that work already started on this. Now I >am looking at the man pages in XML format in doc-new/man/xml/* which are >unto

Re: NewHelpSystem & man pages

C. Florian Ebeling wrote: > On Fri, Apr 10, 2009 at 10:42 PM, Rainer Müller wrote: >> For everyone who did not notice yet what this is about, I documented my >> plans about a new help system based on AsciiDoc at >> . > > Really good to see an initiativ

Re: NewHelpSystem & man pages

On Apr 11, 2009, at 08:36, C. Florian Ebeling wrote: On Fri, Apr 10, 2009 at 10:42 PM, Rainer Müller wrote: For everyone who did not notice yet what this is about, I documented my plans about a new help system based on AsciiDoc at . Really good

Re: NewHelpSystem & man pages

On Fri, Apr 10, 2009 at 10:42 PM, Rainer Müller wrote: > For everyone who did not notice yet what this is about, I documented my > plans about a new help system based on AsciiDoc at > . Really good to see an initiative to shape in the doc area! The cur

Re: NewHelpSystem & man pages

I know that your long term goal was to integrate man pages and guide together. But I didn't know yet that work already started on this. Now I am looking at the man pages in XML format in doc-new/man/xml/* which are untouched for over a year now and thus outdated as we continued to work on t

Re: NewHelpSystem & man pages

For everyone who did not notice yet what this is about, I documented my plans about a new help system based on AsciiDoc at . ma...@macports.org wrote: > I just want to restate that there is a current project underway to source > new man pages out of the