Reference checking py script [was Re: Suggestion for CG - make targets section]

2010-08-18 Thread Trevor Daniels
Trevor Daniels wrote Wednesday, August 18, 2010 12:01 AM You'll also need refcheck.py to check all the cross-references match, but this is rather tied to my particular file structure. I'll have a look at generalising it so I can put it in scripts/auxiliar. I've done this now. See

Re: Suggestion for CG - make targets section

2010-08-18 Thread Phil Holmes
Graham Percival gra...@percival-music.ca wrote in message news:20100817190224.ga30...@sapphire... Also, my background is in computer science, so I don't have a clue what a MOSFET transistor is, so most of the talks were over my head. Metal-Oxide-Semiconductor Field-Effect-Transistor. -

Re: Suggestion for CG - make targets section

2010-08-18 Thread Carl Sorensen
Ian Hulin ian at hulin.org.uk writes: Hi all, I'm just recovering from building and testing my first docs patch *{s\h/u\d/d\e/r\}*. As I didn't know any better, I had to resort to doing make doc and make doc-clean while developing the patch. Thanks to Trevor, we now have some scripts

Re: Suggestion for CG - make targets section

2010-08-18 Thread Trevor Daniels
Carl Sorensen wrote Wednesday, August 18, 2010 5:16 PM Thanks to Trevor, we now have some scripts that will allow you to quickly test only the section of the documentation you are working on. These scripts are now described in CG 4.6 Scripts to ease doc work. I see you noticed the script

Re: Reference checking py script [was Re: Suggestion for CG - make targets section]

2010-08-18 Thread Neil Puttock
On 18 August 2010 13:13, Trevor Daniels t.dani...@treda.co.uk wrote: I've done this now.  See scripts/auxiliar/ref_check.py. Its action is driven by scripts/auxiliar/ref_check.tely Just run it at the top level in the git repository to check (most of) the cross-references in the doc tree.

Re: Reference checking py script [was Re: Suggestion for CG - make targets section]

2010-08-18 Thread Trevor Daniels
Neil Puttock wrote Wednesday, August 18, 2010 9:41 PM On 18 August 2010 13:13, Trevor Daniels t.dani...@treda.co.uk wrote: I've done this now. See scripts/auxiliar/ref_check.py. Its action is driven by scripts/auxiliar/ref_check.tely Just run it at the top level in the git repository to

Suggestion for CG - make targets section

2010-08-17 Thread Ian Hulin
Hi all, I'm just recovering from building and testing my first docs patch *{s\h/u\d/d\e/r\}*. As I didn't know any better, I had to resort to doing make doc and make doc-clean while developing the patch. Firstly, what's the grown-up doc developer's way of this without having to kick off your

Re: Suggestion for CG - make targets section

2010-08-17 Thread Graham Percival
On Tue, Aug 17, 2010 at 07:45:33PM +0100, Ian Hulin wrote: Firstly, what's the grown-up doc developer's way of this without having to kick off your make doc run and then leave it going overnight every time you notice a typo in the doc source? Grown-up developers read the known issues under

Re: Suggestion for CG - make targets section

2010-08-17 Thread Trevor Daniels
Ian Hulin wrote Tuesday, August 17, 2010 7:45 PM I'm just recovering from building and testing my first docs patch *{s\h/u\d/d\e/r\}*. As I didn't know any better, I had to resort to doing make doc and make doc-clean while developing the patch. Firstly, what's the grown-up doc developer's

Re: Suggestion for CG - make targets section

2010-08-17 Thread Carl Sorensen
On 8/17/10 12:45 PM, Ian Hulin i...@hulin.org.uk wrote: Hi all, I'm just recovering from building and testing my first docs patch *{s\h/u\d/d\e/r\}*. As I didn't know any better, I had to resort to doing make doc and make doc-clean while developing the patch. Yes -- make doc is a

Re: Suggestion for CG - make targets section

2010-08-17 Thread Carl Sorensen
On 8/17/10 2:24 PM, Trevor Daniels t.dani...@treda.co.uk wrote: Ian Hulin wrote Tuesday, August 17, 2010 7:45 PM I'm just recovering from building and testing my first docs patch *{s\h/u\d/d\e/r\}*. As I didn't know any better, I had to resort to doing make doc and make doc-clean

Re: Suggestion for CG - make targets section

2010-08-17 Thread Trevor Daniels
Carl Sorensen wrote Tuesday, August 17, 2010 9:45 PM On 8/17/10 2:24 PM, Trevor Daniels t.dani...@treda.co.uk wrote: Ian Hulin wrote Tuesday, August 17, 2010 7:45 PM Firstly, what's the grown-up doc developer's way of this without having to kick off your make doc run and then leave it

Re: Suggestion for CG - make targets section

2010-08-17 Thread Carl Sorensen
On 8/17/10 3:46 PM, Trevor Daniels t.dani...@treda.co.uk wrote: Carl Sorensen wrote Tuesday, August 17, 2010 9:45 PM html file in around 1-2 minutes. PLEASE add an example of your script to the CG, or post it on -devel, or add it to scripts/auxiliar! I have:

Re: Suggestion for CG - make targets section

2010-08-17 Thread Trevor Daniels
Actually, Carl, you would be better off starting with this script. I've just realised it's changed quite a bit since I posted the message a year ago. It's still a bit of a mess though, and you'll obviously have to change the bits specific to me, but it'll give you a useful start. You'll also

Re: Suggestion for CG - make targets section

2010-08-17 Thread Carl Sorensen
On 8/17/10 5:01 PM, Trevor Daniels t.dani...@treda.co.uk wrote: Actually, Carl, you would be better off starting with this script. I've just realised it's changed quite a bit since I posted the message a year ago. It's still a bit of a mess though, and you'll obviously have to change