Re: HelpViewer and .help specs

Hi Riccardo,

On 2026-02-12 12:22:00 +0100 Riccardo Mottola 
<[email protected]> wrote:

> Hi Patrick!
> 
> 
> On 2026-02-07 14:30:18 +0100 Patrick Cardona <[email protected]> 
> wrote:
> 
>> Did You manage to achieve the way help is implemented within GNUstep 
>> apps?
>> Also for the .help specs?
> 
> The parser is stabilized, specs are improving. Nothing radical, no 
> big 
> addition, but some suggestions were implemented if you use the 
> internal 
> parser. Things like
> 
>> As I ported yet once GWorkspace help to this format as I could 
>> understand, 
>> I would like to know if it is accurate.
> 
> oh you already did the work? I m refraining that until Helpiewer 
> works out. 
> The Dennis guide?

Yes it is.

> Just try it out with the internal parser.
> 
>> Also, maybe we could create a repo in purpose to centralize help 
>> contributions?
> 
> Right now, I updated examples so they work better and represent beter 
> the 
> specifications.

I will look at those examples from the svn repo.

> Still, I think every project should have its own file, not a 
> centralized help 
> file repository.

I agree, but what about many localized .help bundle?
I thought it could be a way to dispatch the work:
- In the app, the native default .help bundle (let say in English).
- In the site, the many translations.
- Then a way (a Localisation wizard?) to retrieve and to install the 
localized bundles that matter for the end user for each app.

> 
> Right now, HelpViewer uncovered an issue in libs-gui itself and it is 
> hard, 
> many weeks we are working on that, not easy at all. We are reviewing 
> the 
> code. Check PR #392 if you wish.

I will follow this too.

Cheers,
Patrick

-- 
Patrick Cardona - Pi400 - GNU/Linux aarch64 (Debian 13.3)
Xorg (1:7.7+24) - libcairo2 (1.18.4-1+rpt1 arm64)
Window Maker (0.96.0-4) - GWorkspace (1.1.0 - 02 2025) - Theme: 
AGNOSTEP - MUA: GNUMail (rev.947)