Re: new feature: how to document it?

Hi Lionel,
On 22/04/2013 11:20, Lionel Elie Mamane wrote:
> On Mon, Apr 22, 2013 at 11:11:46AM +0200, Lionel Elie Mamane wrote:
> > > Le 20/04/2013 23:34, Lionel Elie Mamane a écrit :
>
> > > > One last question: where can I edit the help to document a new feature
> > > > I'm introducing (namely, the option that the storage value is the
> > > > index in the list)? I grepped for a string that appears in the right
> > > > help page, but no result. In particular, I did not find it in the
> > > > "helpcontent2" directory. Also, do we have our fork of the<
> > > > OpenOffice.org Developer's Guide?
>
> > When I'm editing the properties of a listbox,
> > in the data tab and I press "F1" I get a new window entitled
> > "LibreOffice Help - LibreOffice Base", with content like below. That's
> > what I intended to change.
>
> > I tried grepping for "allows you to assign a data source" in the
> > LibreOffice source code to find the file I'm supposed to change, no
> > luck.
>
> It turns out, "git grep" does not go into submodules :-|
>
> I was doing:
>
> $ git grep -i 'allows you to assign a data source'
> $ git grep -i 'allows you to assign a data source' -- helpcontent2/
>
> This got me going:
>
> $ cd helpcontent2 && git grep -i 'allows you to assign a data source'
>
>
> Are the identifiers like id="par_id3154206" essentially random (and I
> can just put other random ones for new paragraphs), or do they have
> some hidden meaning (and then please explain me how to generate the id
> for a paragraph I'm adding).

I get it too with in share/02 file 01170102.xhp par_id3155306 2 help.text
In id="par_xxx", the 'par' part indicate a paragraph, and the 'xxx' part
can be any random numbers, but must be unique in the .xhp file.

Kind regards
Sophie

-- 
Sophie Gautier <sophie.gautier@documentfoundation.org>
Tel:+33683901545
Membership & Certification Committee Member - Co-founder
The Document Foundation