Re: [boost] [release notes] Linking to github issues/pull requests

Subject: Re: [boost] [release notes] Linking to github issues/pull requests
From: Stefan Seefeld (stefan_at_[hidden])
Date: 2018-02-14 12:51:50

On 14.02.2018 07:48, Daniel James via Boost wrote:
> On 14 February 2018 at 12:15, Stefan Seefeld via Boost
> <boost_at_[hidden]> wrote:
>> I see these templates are defined in `website/feed/ext.qbk`. How or when
>> is that source being pulled into the documentation ? (That's presumably
>> what you are referring to as "release notes infrastructure" ?)
> There's an '[import ext.qbk]' at the top of the release notes, which
> imports all the templates and macros. When building the release notes
> quickbook is called with the appropriate include path (i.e. something
> like 'quickbook feed/history/boost_1_66_0.qbk -I feed/').
>
> You can add an include path in Boost Build using '<include>':
>
>     path-constant include_path : path-to-include-dir ;
>
>     xml target : source.qbk : <include>$(include_path) ;

Thanks !
>> As I mentioned in a prior reply in this thread, I'd really like to be
>> able to use such features in my projects' own documentation, i.e. as
>> part of a regular documentation build, which has no notion of the above
>> `website` code. But that would only work if such templates would become
>> part of `quickbook` itself, rather than being integrated into a separate
>> boost module such as `website`.
> I wouldn't want to make something so specific part of the language. We
> could make a template library available somewhere though.

Exactly, that's what I had in mind: some "runtime" that's part of the
documentation module itself, rather than "website" or other mostly
independent downstream project.

Regards,

Stefan

-- 
      ...ich hab' noch einen Koffer in Berlin...