Boost website changes and .'cxxstd'

classic Classic list List threaded Threaded
46 messages Options
123
Reply | Threaded
Open this post in threaded view
|

Boost website changes and .'cxxstd'

Boost - Dev mailing list
Even though I have worked a little with PHP in the past I do not have
the talent to make the change to the website which would incorporate the
addition of the meta information json field 'cxxstd' to the Boost
documentation web page for each library. The idea is that if 'cxxstd' is
set to a value the documentation for that library would also show:

C++ standard minimum level: C++nn

where nn would be 11, 14, 17, or 20 depending on the value of 'cxxstd'.
Alternatively if there is no 'cxxstd' entry for a library or if the
value of 'cxxstd' is '03', we could either specify 'nn' as '03' or leave
off the line stating the 'C++ standard minimum level completely.

On the face of it this should be doable in the website code but
evidently Daniel James is the only one who really understands how this
works in the code and he is no longer active in Boost. So if someone
else who understands the website code and PHP could do this it would be
appreciated, since I think it will be valuable telling end-users whether
a Boost library is usable at the C++ compiler level they are using.


_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
On Wed, Dec 23, 2020 at 6:39 PM Edward Diener via Boost <
[hidden email]> wrote:

> Even though I have worked a little with PHP in the past I do not have
> the talent to make the change to the website which would incorporate the
> addition of the meta information json field 'cxxstd' to the Boost
> documentation web page for each library. The idea is that if 'cxxstd' is
> set to a value the documentation for that library would also show:
>
> C++ standard minimum level: C++nn
>
> where nn would be 11, 14, 17, or 20 depending on the value of 'cxxstd'.
> Alternatively if there is no 'cxxstd' entry for a library or if the
> value of 'cxxstd' is '03', we could either specify 'nn' as '03' or leave
> off the line stating the 'C++ standard minimum level completely.
>
> On the face of it this should be doable in the website code but
> evidently Daniel James is the only one who really understands how this
> works in the code and he is no longer active in Boost. So if someone
> else who understands the website code and PHP could do this it would be
> appreciated, since I think it will be valuable telling end-users whether
> a Boost library is usable at the C++ compiler level they are using.
>

Unless there is someone in the community who wants to take on website
maintenance, would this be an opportune time for the organization to spend
some of its money to hire a web developer? There's a lot that could be
improved with the website.

Tom

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
On Thu, Dec 24, 2020 at 10:57 AM Tom Kent via Boost
<[hidden email]> wrote:
> Unless there is someone in the community who wants to take on website
> maintenance, would this be an opportune time for the organization to spend
> some of its money to hire a web developer? There's a lot that could be
> improved with the website.

Sam Darwin should be able to take care of this, I will bring it to his
attention.

Thanks

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
On 12/24/2020 3:23 PM, Vinnie Falco via Boost wrote:
> On Thu, Dec 24, 2020 at 10:57 AM Tom Kent via Boost
> <[hidden email]> wrote:
>> Unless there is someone in the community who wants to take on website
>> maintenance, would this be an opportune time for the organization to spend
>> some of its money to hire a web developer? There's a lot that could be
>> improved with the website.
>
> Sam Darwin should be able to take care of this, I will bring it to his
> attention.

Thanks Vinny !


_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
In reply to this post by Boost - Dev mailing list
I can look into it. But needs to make the requirements clear.

So, the task is to show *C++ standard minimum level: C++nn* for Standard
attribute for each lib in this page: C++ standard minimum level: C++nn ?
And we could replace nn with the actual number by checking the *cxxstd* key
in a library's meta info json file.

Please let me know if I got it right.

On Fri, Dec 25, 2020 at 10:00 AM Louis Tatta <[hidden email]> wrote:

>
>
> ---------- Forwarded message ---------
> From: Edward Diener via Boost <[hidden email]>
> Date: Wed, Dec 23, 2020 at 7:39 PM
> Subject: [boost] Boost website changes and .'cxxstd'
> To: <[hidden email]>
> CC: Edward Diener <[hidden email]>
>
>
> Even though I have worked a little with PHP in the past I do not have
> the talent to make the change to the website which would incorporate the
> addition of the meta information json field 'cxxstd' to the Boost
> documentation web page for each library. The idea is that if 'cxxstd' is
> set to a value the documentation for that library would also show:
>
> C++ standard minimum level: C++nn
>
> where nn would be 11, 14, 17, or 20 depending on the value of 'cxxstd'.
> Alternatively if there is no 'cxxstd' entry for a library or if the
> value of 'cxxstd' is '03', we could either specify 'nn' as '03' or leave
> off the line stating the 'C++ standard minimum level completely.
>
> On the face of it this should be doable in the website code but
> evidently Daniel James is the only one who really understands how this
> works in the code and he is no longer active in Boost. So if someone
> else who understands the website code and PHP could do this it would be
> appreciated, since I think it will be valuable telling end-users whether
> a Boost library is usable at the C++ compiler level they are using.
>
>
> _______________________________________________
> Unsubscribe & other changes:
> http://lists.boost.org/mailman/listinfo.cgi/boost
>

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
Sorry, just missed the link: https://www.boost.org/doc/libs/

On Fri, Dec 25, 2020 at 10:10 AM Donovan Dikaio <[hidden email]> wrote:

> I can look into it. But needs to make the requirements clear.
>
> So, the task is to show *C++ standard minimum level: C++nn* for Standard
> attribute for each lib in this page: C++ standard minimum level: C++nn ?
> And we could replace nn with the actual number by checking the *cxxstd* key
> in a library's meta info json file.
>
> Please let me know if I got it right.
>
> On Fri, Dec 25, 2020 at 10:00 AM Louis Tatta <[hidden email]>
> wrote:
>
>>
>>
>> ---------- Forwarded message ---------
>> From: Edward Diener via Boost <[hidden email]>
>> Date: Wed, Dec 23, 2020 at 7:39 PM
>> Subject: [boost] Boost website changes and .'cxxstd'
>> To: <[hidden email]>
>> CC: Edward Diener <[hidden email]>
>>
>>
>> Even though I have worked a little with PHP in the past I do not have
>> the talent to make the change to the website which would incorporate the
>> addition of the meta information json field 'cxxstd' to the Boost
>> documentation web page for each library. The idea is that if 'cxxstd' is
>> set to a value the documentation for that library would also show:
>>
>> C++ standard minimum level: C++nn
>>
>> where nn would be 11, 14, 17, or 20 depending on the value of 'cxxstd'.
>> Alternatively if there is no 'cxxstd' entry for a library or if the
>> value of 'cxxstd' is '03', we could either specify 'nn' as '03' or leave
>> off the line stating the 'C++ standard minimum level completely.
>>
>> On the face of it this should be doable in the website code but
>> evidently Daniel James is the only one who really understands how this
>> works in the code and he is no longer active in Boost. So if someone
>> else who understands the website code and PHP could do this it would be
>> appreciated, since I think it will be valuable telling end-users whether
>> a Boost library is usable at the C++ compiler level they are using.
>>
>>
>> _______________________________________________
>> Unsubscribe & other changes:
>> http://lists.boost.org/mailman/listinfo.cgi/boost
>>
>

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
On Fri, Dec 25, 2020 at 10:29 AM Donovan Dikaio <[hidden email]> wrote:

> Sorry, just missed the link: https://www.boost.org/doc/libs/
>
> On Fri, Dec 25, 2020 at 10:10 AM Donovan Dikaio <[hidden email]>
> wrote:
>
>> I can look into it. But needs to make the requirements clear.
>>
>> So, the task is to show *C++ standard minimum level: C++nn* for Standard
>> attribute for each lib in this page: C++ standard minimum level: C++nn ?
>> And we could replace nn with the actual number by checking the *cxxstd* key
>> in a library's meta info json file.
>>
>> Please let me know if I got it right.
>>
>> On Fri, Dec 25, 2020 at 10:00 AM Louis Tatta <[hidden email]>
>> wrote:
>>
>>>
>>>
>>> ---------- Forwarded message ---------
>>> From: Edward Diener via Boost <[hidden email]>
>>> Date: Wed, Dec 23, 2020 at 7:39 PM
>>> Subject: [boost] Boost website changes and .'cxxstd'
>>> To: <[hidden email]>
>>> CC: Edward Diener <[hidden email]>
>>>
>>>
>>> Even though I have worked a little with PHP in the past I do not have
>>> the talent to make the change to the website which would incorporate the
>>> addition of the meta information json field 'cxxstd' to the Boost
>>> documentation web page for each library. The idea is that if 'cxxstd' is
>>> set to a value the documentation for that library would also show:
>>>
>>> C++ standard minimum level: C++nn
>>>
>>> where nn would be 11, 14, 17, or 20 depending on the value of 'cxxstd'.
>>> Alternatively if there is no 'cxxstd' entry for a library or if the
>>> value of 'cxxstd' is '03', we could either specify 'nn' as '03' or leave
>>> off the line stating the 'C++ standard minimum level completely.
>>>
>>> On the face of it this should be doable in the website code but
>>> evidently Daniel James is the only one who really understands how this
>>> works in the code and he is no longer active in Boost. So if someone
>>> else who understands the website code and PHP could do this it would be
>>> appreciated, since I think it will be valuable telling end-users whether
>>> a Boost library is usable at the C++ compiler level they are using.
>>>
>>>
>>> _______________________________________________
>>> Unsubscribe & other changes:
>>> http://lists.boost.org/mailman/listinfo.cgi/boost
>>>
>>


_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost

Screenshot.png (69K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
In reply to this post by Boost - Dev mailing list
On 12/24/2020 9:10 PM, Donovan Dikaio via Boost wrote:
> I can look into it. But needs to make the requirements clear.
>
> So, the task is to show *C++ standard minimum level: C++nn* for Standard
> attribute for each lib in this page: C++ standard minimum level: C++nn ?
> And we could replace nn with the actual number by checking the *cxxstd* key
> in a library's meta info json file.
>
> Please let me know if I got it right.

No, the current 'Standard' mnemonic is not used by the 'cxxstd' change.
Instead create a new mnemonic called "C++ standard minimum level" with
the value of 03,11,14,17,20 depending on the value of the meta file json
field 'cxxstd'. If the meta file json field 'cxxstd' does not exist in a
library's meta file, the value of 03 is assumed. Currently I have only
attempted to update the meta file with the new 'cxxstd' field and
appropriate value for libraries whose minimum support is C++11 or above,
with PRs. I am still waiting for four of those libraries to merge their
PRs on the 'develop' branch:

callable_traits
coroutine2
hof
hana

There has also been a suggestion to remove the 'Standard' mnemonic
entirely from the documentation for each library, since its previous
usage is out of date and has been totally irrelevant for a long time
now, and therefore ignore or remove the 'std' meta file json field. I am
in favor of that also, but others may be against it. I would also not
want to reuse that 'Standard' mnemonic instead of the more precise one
of 'C++ standard minimum level', which is easily understood. If someone
would like to argue for 'C++ standard minimum level required' that is
even better but may be too long.


>
> On Fri, Dec 25, 2020 at 10:00 AM Louis Tatta <[hidden email]> wrote:
>
>>
>>
>> ---------- Forwarded message ---------
>> From: Edward Diener via Boost <[hidden email]>
>> Date: Wed, Dec 23, 2020 at 7:39 PM
>> Subject: [boost] Boost website changes and .'cxxstd'
>> To: <[hidden email]>
>> CC: Edward Diener <[hidden email]>
>>
>>
>> Even though I have worked a little with PHP in the past I do not have
>> the talent to make the change to the website which would incorporate the
>> addition of the meta information json field 'cxxstd' to the Boost
>> documentation web page for each library. The idea is that if 'cxxstd' is
>> set to a value the documentation for that library would also show:
>>
>> C++ standard minimum level: C++nn
>>
>> where nn would be 11, 14, 17, or 20 depending on the value of 'cxxstd'.
>> Alternatively if there is no 'cxxstd' entry for a library or if the
>> value of 'cxxstd' is '03', we could either specify 'nn' as '03' or leave
>> off the line stating the 'C++ standard minimum level completely.
>>
>> On the face of it this should be doable in the website code but
>> evidently Daniel James is the only one who really understands how this
>> works in the code and he is no longer active in Boost. So if someone
>> else who understands the website code and PHP could do this it would be
>> appreciated, since I think it will be valuable telling end-users whether
>> a Boost library is usable at the C++ compiler level they are using.
>>
>>
>> _______________________________________________
>> Unsubscribe & other changes:
>> http://lists.boost.org/mailman/listinfo.cgi/boost
>>
>
> _______________________________________________
> Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
>



_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
In reply to this post by Boost - Dev mailing list
On 12/24/2020 9:29 PM, Donovan Dikaio via Boost wrote:
> On Fri, Dec 25, 2020 at 10:29 AM Donovan Dikaio <[hidden email]> wrote:
>
>> Sorry, just missed the link: https://www.boost.org/doc/libs/

The 'Standard' mnemonic based on the 'std' meta file json field has
nothing to do with the new 'cxxstd' meta file json field.

>>
>> On Fri, Dec 25, 2020 at 10:10 AM Donovan Dikaio <[hidden email]>
>> wrote:
>>
>>> I can look into it. But needs to make the requirements clear.
>>>
>>> So, the task is to show *C++ standard minimum level: C++nn* for Standard
>>> attribute for each lib in this page: C++ standard minimum level: C++nn ?
>>> And we could replace nn with the actual number by checking the *cxxstd* key
>>> in a library's meta info json file.
>>>
>>> Please let me know if I got it right.
>>>
>>> On Fri, Dec 25, 2020 at 10:00 AM Louis Tatta <[hidden email]>
>>> wrote:
>>>
>>>>
>>>>
>>>> ---------- Forwarded message ---------
>>>> From: Edward Diener via Boost <[hidden email]>
>>>> Date: Wed, Dec 23, 2020 at 7:39 PM
>>>> Subject: [boost] Boost website changes and .'cxxstd'
>>>> To: <[hidden email]>
>>>> CC: Edward Diener <[hidden email]>
>>>>
>>>>
>>>> Even though I have worked a little with PHP in the past I do not have
>>>> the talent to make the change to the website which would incorporate the
>>>> addition of the meta information json field 'cxxstd' to the Boost
>>>> documentation web page for each library. The idea is that if 'cxxstd' is
>>>> set to a value the documentation for that library would also show:
>>>>
>>>> C++ standard minimum level: C++nn
>>>>
>>>> where nn would be 11, 14, 17, or 20 depending on the value of 'cxxstd'.
>>>> Alternatively if there is no 'cxxstd' entry for a library or if the
>>>> value of 'cxxstd' is '03', we could either specify 'nn' as '03' or leave
>>>> off the line stating the 'C++ standard minimum level completely.
>>>>
>>>> On the face of it this should be doable in the website code but
>>>> evidently Daniel James is the only one who really understands how this
>>>> works in the code and he is no longer active in Boost. So if someone
>>>> else who understands the website code and PHP could do this it would be
>>>> appreciated, since I think it will be valuable telling end-users whether
>>>> a Boost library is usable at the C++ compiler level they are using.
>>>>
>>>>
>>>> _______________________________________________
>>>> Unsubscribe & other changes:
>>>> http://lists.boost.org/mailman/listinfo.cgi/boost
>>>>
>>>
>>>
>>>
>>> _______________________________________________
>>> Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost



_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
In reply to this post by Boost - Dev mailing list
Beta branch of the website has been updated.

It shows the *C++ standard minimum level* just below *Standard* field with
the value from *cxxstd* attribute if a valid one exists for a library.

Please review and let me know your comments.

On Fri, Dec 25, 2020 at 10:29 AM Donovan Dikaio <[hidden email]> wrote:

>
>
> On Fri, Dec 25, 2020 at 10:29 AM Donovan Dikaio <[hidden email]>
> wrote:
>
>> Sorry, just missed the link: https://www.boost.org/doc/libs/
>>
>> On Fri, Dec 25, 2020 at 10:10 AM Donovan Dikaio <[hidden email]>
>> wrote:
>>
>>> I can look into it. But needs to make the requirements clear.
>>>
>>> So, the task is to show *C++ standard minimum level: C++nn* for
>>> Standard attribute for each lib in this page: C++ standard minimum level:
>>> C++nn ?
>>> And we could replace nn with the actual number by checking the *cxxstd* key
>>> in a library's meta info json file.
>>>
>>> Please let me know if I got it right.
>>>
>>> On Fri, Dec 25, 2020 at 10:00 AM Louis Tatta <[hidden email]>
>>> wrote:
>>>
>>>>
>>>>
>>>> ---------- Forwarded message ---------
>>>> From: Edward Diener via Boost <[hidden email]>
>>>> Date: Wed, Dec 23, 2020 at 7:39 PM
>>>> Subject: [boost] Boost website changes and .'cxxstd'
>>>> To: <[hidden email]>
>>>> CC: Edward Diener <[hidden email]>
>>>>
>>>>
>>>> Even though I have worked a little with PHP in the past I do not have
>>>> the talent to make the change to the website which would incorporate
>>>> the
>>>> addition of the meta information json field 'cxxstd' to the Boost
>>>> documentation web page for each library. The idea is that if 'cxxstd'
>>>> is
>>>> set to a value the documentation for that library would also show:
>>>>
>>>> C++ standard minimum level: C++nn
>>>>
>>>> where nn would be 11, 14, 17, or 20 depending on the value of 'cxxstd'.
>>>> Alternatively if there is no 'cxxstd' entry for a library or if the
>>>> value of 'cxxstd' is '03', we could either specify 'nn' as '03' or
>>>> leave
>>>> off the line stating the 'C++ standard minimum level completely.
>>>>
>>>> On the face of it this should be doable in the website code but
>>>> evidently Daniel James is the only one who really understands how this
>>>> works in the code and he is no longer active in Boost. So if someone
>>>> else who understands the website code and PHP could do this it would be
>>>> appreciated, since I think it will be valuable telling end-users
>>>> whether
>>>> a Boost library is usable at the C++ compiler level they are using.
>>>>
>>>>
>>>> _______________________________________________
>>>> Unsubscribe & other changes:
>>>> http://lists.boost.org/mailman/listinfo.cgi/boost
>>>>
>>>

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
On 12/29/2020 12:44 PM, Donovan Dikaio via Boost wrote:
> Beta branch of the website has been updated.
>
> It shows the *C++ standard minimum level* just below *Standard* field with
> the value from *cxxstd* attribute if a valid one exists for a library.
>
> Please review and let me know your comments.

How do I see the beta website ? I tried https://beta.boost.org/ but the
latest release mentioned there is 1.72 and when I look at the
documentation for that release I do not see the information you mention
above.

>
> On Fri, Dec 25, 2020 at 10:29 AM Donovan Dikaio <[hidden email]> wrote:
>
>>
>>
>> On Fri, Dec 25, 2020 at 10:29 AM Donovan Dikaio <[hidden email]>
>> wrote:
>>
>>> Sorry, just missed the link: https://www.boost.org/doc/libs/
>>>
>>> On Fri, Dec 25, 2020 at 10:10 AM Donovan Dikaio <[hidden email]>
>>> wrote:
>>>
>>>> I can look into it. But needs to make the requirements clear.
>>>>
>>>> So, the task is to show *C++ standard minimum level: C++nn* for
>>>> Standard attribute for each lib in this page: C++ standard minimum level:
>>>> C++nn ?
>>>> And we could replace nn with the actual number by checking the *cxxstd* key
>>>> in a library's meta info json file.
>>>>
>>>> Please let me know if I got it right.
>>>>
>>>> On Fri, Dec 25, 2020 at 10:00 AM Louis Tatta <[hidden email]>
>>>> wrote:
>>>>
>>>>>
>>>>>
>>>>> ---------- Forwarded message ---------
>>>>> From: Edward Diener via Boost <[hidden email]>
>>>>> Date: Wed, Dec 23, 2020 at 7:39 PM
>>>>> Subject: [boost] Boost website changes and .'cxxstd'
>>>>> To: <[hidden email]>
>>>>> CC: Edward Diener <[hidden email]>
>>>>>
>>>>>
>>>>> Even though I have worked a little with PHP in the past I do not have
>>>>> the talent to make the change to the website which would incorporate
>>>>> the
>>>>> addition of the meta information json field 'cxxstd' to the Boost
>>>>> documentation web page for each library. The idea is that if 'cxxstd'
>>>>> is
>>>>> set to a value the documentation for that library would also show:
>>>>>
>>>>> C++ standard minimum level: C++nn
>>>>>
>>>>> where nn would be 11, 14, 17, or 20 depending on the value of 'cxxstd'.
>>>>> Alternatively if there is no 'cxxstd' entry for a library or if the
>>>>> value of 'cxxstd' is '03', we could either specify 'nn' as '03' or
>>>>> leave
>>>>> off the line stating the 'C++ standard minimum level completely.
>>>>>
>>>>> On the face of it this should be doable in the website code but
>>>>> evidently Daniel James is the only one who really understands how this
>>>>> works in the code and he is no longer active in Boost. So if someone
>>>>> else who understands the website code and PHP could do this it would be
>>>>> appreciated, since I think it will be valuable telling end-users
>>>>> whether
>>>>> a Boost library is usable at the C++ compiler level they are using.


_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
In reply to this post by Boost - Dev mailing list

Am 29.12.20 um 18:44 schrieb Donovan Dikaio via Boost:
> Beta branch of the website has been updated.
>
> It shows the *C++ standard minimum level* just below *Standard* field with
> the value from *cxxstd* attribute if a valid one exists for a library.
Is there a link with how it looks like with current develop branch?

BTW: Thanks for *not* showing anything when the cxxstd attribute does
not exist. It was asked before to "assume C++03" in that case which I
(repeatably) argued before is wrong as it tells users "it will work for
you" when in fact it is missing any information and hence makes the
"C++03" label pretty much worthless. If the maintainer cares he/she can
now add the "03" to the library and be done.

As special cases with Boost.Math came up: How about allowing a string
value in the attribute so it can be e.g. "C++11 (mixed)" or something
similar to hint that not everything will work with C++11 but that is the
minimum supported level (note the "supported": C++03 might work but if
it is untested it might as well not and hence doesn't belong here)




_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost

smime.p7s (6K) Download Attachment
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
It looks like we have an open pull request to update the website to
show this data - is there any progress on reviewing it? What is the
next step?

Thanks

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
On Monday, January 4, 2021, Vinnie Falco wrote:

> It looks like we have an open pull request to update the website to
> show this data - is there any progress on reviewing it?
>


I don't see any open PR:
 https://github.com/boostorg/website/pulls

Glen

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
In reply to this post by Boost - Dev mailing list
The updates to show "C++ standard minimum level" is just live here:
https://www.boost.org/doc/libs/master/

On Wed, Dec 30, 2020 at 1:44 AM Donovan Dikaio <[hidden email]> wrote:

> Beta branch of the website has been updated.
>
> It shows the *C++ standard minimum level* just below *Standard* field
> with the value from *cxxstd* attribute if a valid one exists for a
> library.
>
> Please review and let me know your comments.
>
> On Fri, Dec 25, 2020 at 10:29 AM Donovan Dikaio <[hidden email]>
> wrote:
>
>>
>>
>> On Fri, Dec 25, 2020 at 10:29 AM Donovan Dikaio <[hidden email]>
>> wrote:
>>
>>> Sorry, just missed the link: https://www.boost.org/doc/libs/
>>>
>>> On Fri, Dec 25, 2020 at 10:10 AM Donovan Dikaio <[hidden email]>
>>> wrote:
>>>
>>>> I can look into it. But needs to make the requirements clear.
>>>>
>>>> So, the task is to show *C++ standard minimum level: C++nn* for
>>>> Standard attribute for each lib in this page: C++ standard minimum level:
>>>> C++nn ?
>>>> And we could replace nn with the actual number by checking the *cxxstd* key
>>>> in a library's meta info json file.
>>>>
>>>> Please let me know if I got it right.
>>>>
>>>> On Fri, Dec 25, 2020 at 10:00 AM Louis Tatta <[hidden email]>
>>>> wrote:
>>>>
>>>>>
>>>>>
>>>>> ---------- Forwarded message ---------
>>>>> From: Edward Diener via Boost <[hidden email]>
>>>>> Date: Wed, Dec 23, 2020 at 7:39 PM
>>>>> Subject: [boost] Boost website changes and .'cxxstd'
>>>>> To: <[hidden email]>
>>>>> CC: Edward Diener <[hidden email]>
>>>>>
>>>>>
>>>>> Even though I have worked a little with PHP in the past I do not have
>>>>> the talent to make the change to the website which would incorporate
>>>>> the
>>>>> addition of the meta information json field 'cxxstd' to the Boost
>>>>> documentation web page for each library. The idea is that if 'cxxstd'
>>>>> is
>>>>> set to a value the documentation for that library would also show:
>>>>>
>>>>> C++ standard minimum level: C++nn
>>>>>
>>>>> where nn would be 11, 14, 17, or 20 depending on the value of
>>>>> 'cxxstd'.
>>>>> Alternatively if there is no 'cxxstd' entry for a library or if the
>>>>> value of 'cxxstd' is '03', we could either specify 'nn' as '03' or
>>>>> leave
>>>>> off the line stating the 'C++ standard minimum level completely.
>>>>>
>>>>> On the face of it this should be doable in the website code but
>>>>> evidently Daniel James is the only one who really understands how this
>>>>> works in the code and he is no longer active in Boost. So if someone
>>>>> else who understands the website code and PHP could do this it would
>>>>> be
>>>>> appreciated, since I think it will be valuable telling end-users
>>>>> whether
>>>>> a Boost library is usable at the C++ compiler level they are using.
>>>>>
>>>>>
>>>>> _______________________________________________
>>>>> Unsubscribe & other changes:
>>>>> http://lists.boost.org/mailman/listinfo.cgi/boost
>>>>>
>>>>

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
On 1/6/2021 2:00 PM, Donovan Dikaio via Boost wrote:
> The updates to show "C++ standard minimum level" is just live here:
> https://www.boost.org/doc/libs/master/

Excellent !

Ideally if there is no 'cxxstd' json value, I think the "C++ standard
minimum level" should say '03' rather than be left out completely. This
will be incorrect for those libraries who have not yet merged the
'development' branch change for 'cxxstd' into 'master' yet. But once
these libraries merge the change into their 'master' branch the correct
"C++ standard minimum level" would then be shown for all libraries, and
all libraries would have a "C++ standard minimum level" displayed, which
I think is more consistent with what end-users would want to see. Yes, I
could have created PRs for all the Boost C++03 minimum standard
libraries also, like Alexander Grund suggested, but I thought that was
too much work creating some 110 PRs or so for those libraries, so I only
updated the libraries I maintained with a "cxxstd": "03" values.

For the beta website we should probably use the 'develop' branch
'libraries.json' values for each library, and this would correctly show
right now the correct "C++ standard minimum level" for those 25
libraries which have updated my PRs on their 'develop' branch for
'cxxstd'. But I understand that you have had problems getting the beta
website to integrate your changes in its display.

>
> On Wed, Dec 30, 2020 at 1:44 AM Donovan Dikaio <[hidden email]> wrote:
>
>> Beta branch of the website has been updated.
>>
>> It shows the *C++ standard minimum level* just below *Standard* field
>> with the value from *cxxstd* attribute if a valid one exists for a
>> library.
>>
>> Please review and let me know your comments.
>>
>> On Fri, Dec 25, 2020 at 10:29 AM Donovan Dikaio <[hidden email]>
>> wrote:
>>
>>>
>>>
>>> On Fri, Dec 25, 2020 at 10:29 AM Donovan Dikaio <[hidden email]>
>>> wrote:
>>>
>>>> Sorry, just missed the link: https://www.boost.org/doc/libs/
>>>>
>>>> On Fri, Dec 25, 2020 at 10:10 AM Donovan Dikaio <[hidden email]>
>>>> wrote:
>>>>
>>>>> I can look into it. But needs to make the requirements clear.
>>>>>
>>>>> So, the task is to show *C++ standard minimum level: C++nn* for
>>>>> Standard attribute for each lib in this page: C++ standard minimum level:
>>>>> C++nn ?
>>>>> And we could replace nn with the actual number by checking the *cxxstd* key
>>>>> in a library's meta info json file.
>>>>>
>>>>> Please let me know if I got it right.
>>>>>
>>>>> On Fri, Dec 25, 2020 at 10:00 AM Louis Tatta <[hidden email]>
>>>>> wrote:
>>>>>
>>>>>>
>>>>>>
>>>>>> ---------- Forwarded message ---------
>>>>>> From: Edward Diener via Boost <[hidden email]>
>>>>>> Date: Wed, Dec 23, 2020 at 7:39 PM
>>>>>> Subject: [boost] Boost website changes and .'cxxstd'
>>>>>> To: <[hidden email]>
>>>>>> CC: Edward Diener <[hidden email]>
>>>>>>
>>>>>>
>>>>>> Even though I have worked a little with PHP in the past I do not have
>>>>>> the talent to make the change to the website which would incorporate
>>>>>> the
>>>>>> addition of the meta information json field 'cxxstd' to the Boost
>>>>>> documentation web page for each library. The idea is that if 'cxxstd'
>>>>>> is
>>>>>> set to a value the documentation for that library would also show:
>>>>>>
>>>>>> C++ standard minimum level: C++nn
>>>>>>
>>>>>> where nn would be 11, 14, 17, or 20 depending on the value of
>>>>>> 'cxxstd'.
>>>>>> Alternatively if there is no 'cxxstd' entry for a library or if the
>>>>>> value of 'cxxstd' is '03', we could either specify 'nn' as '03' or
>>>>>> leave
>>>>>> off the line stating the 'C++ standard minimum level completely.
>>>>>>
>>>>>> On the face of it this should be doable in the website code but
>>>>>> evidently Daniel James is the only one who really understands how this
>>>>>> works in the code and he is no longer active in Boost. So if someone
>>>>>> else who understands the website code and PHP could do this it would
>>>>>> be
>>>>>> appreciated, since I think it will be valuable telling end-users
>>>>>> whether
>>>>>> a Boost library is usable at the C++ compiler level they are using.
>>>>>>
>>>>>>
>>>>>> _______________________________________________
>>>>>> Unsubscribe & other changes:
>>>>>> http://lists.boost.org/mailman/listinfo.cgi/boost
>>>>>>
>>>>>
>
> _______________________________________________
> Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
>



_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
On Wed, Jan 6, 2021 at 1:34 PM Edward Diener via Boost <
[hidden email]> wrote:

> On 1/6/2021 2:00 PM, Donovan Dikaio via Boost wrote:
> > The updates to show "C++ standard minimum level" is just live here:
> > https://www.boost.org/doc/libs/master/
>
> Excellent !
>
> Ideally if there is no 'cxxstd' json value, I think the "C++ standard
> minimum level" should say '03' rather than be left out completely. This
> will be incorrect for those libraries who have not yet merged the
> 'development' branch change for 'cxxstd' into 'master' yet. But once
> these libraries merge the change into their 'master' branch the correct
> "C++ standard minimum level" would then be shown for all libraries, and
> all libraries would have a "C++ standard minimum level" displayed, which
> I think is more consistent with what end-users would want to see.
>

Please do not do this. It would subvert the possible intent of libraries
that do not wish to peg themselves at a particular C++ level. It would also
likely show incorrrect information for the libraries that could be C++98
and have not gotten around to adding this field to reflect it as such.


--
-- René Ferdinand Rivera Morell
-- Don't Assume Anything  -- No Supone Nada
-- Robot Dreams - http://robot-dreams.net

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
On 1/6/2021 2:41 PM, René Ferdinand Rivera Morell via Boost wrote:

> On Wed, Jan 6, 2021 at 1:34 PM Edward Diener via Boost <
> [hidden email]> wrote:
>
>> On 1/6/2021 2:00 PM, Donovan Dikaio via Boost wrote:
>>> The updates to show "C++ standard minimum level" is just live here:
>>> https://www.boost.org/doc/libs/master/
>>
>> Excellent !
>>
>> Ideally if there is no 'cxxstd' json value, I think the "C++ standard
>> minimum level" should say '03' rather than be left out completely. This
>> will be incorrect for those libraries who have not yet merged the
>> 'development' branch change for 'cxxstd' into 'master' yet. But once
>> these libraries merge the change into their 'master' branch the correct
>> "C++ standard minimum level" would then be shown for all libraries, and
>> all libraries would have a "C++ standard minimum level" displayed, which
>> I think is more consistent with what end-users would want to see.
>>
>
> Please do not do this. It would subvert the possible intent of libraries
> that do not wish to peg themselves at a particular C++ level. It would also
> likely show incorrrect information for the libraries that could be C++98
> and have not gotten around to adding this field to reflect it as such.

If an end-user does not see a "C++ standard minimum level" for a library
in the documentation what should he/she assume ? I would like to argue
that it would be beneficial for end-users to see the C++ standard
minimum level for all libraries, even for those which work at the
C++98/03 level on up. I do not understand the purpose of a library which
does not wish to peg itself at a particular minimum C++ level. A library
could have 25 pieces of functionality, 5 of which work at the C++03
level, 5 of which work at the C++11 level, 5 of which work at the C++14
level, 5 of which work at the C++17 level, and 5 of which work at the
C++20 level, but how likely is that and what good does it do to
represent such a library as not having any C++ standard minimum level ?
Specifying a C++ standard minimum level does not mean that there is not
functionality in a library which might require a higher C++ standard
level in order to work properly. We are just trying to give end-users an
idea of the minimum C++ standard level needed to work with the majority
of functionality in a Boost library. In particular specifying a C++
standard minimum level of '03' does not mean that there might be some
functionality in the library which requires C++11 ( or higher ).


_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
On Wed, Jan 6, 2021 at 2:02 PM Edward Diener via Boost <
[hidden email]> wrote:

>
> If an end-user does not see a "C++ standard minimum level" for a library
> in the documentation what should he/she assume ?


They should *not* assume any particular level. And perhaps ask the author
to indicate what the support is by filling GitHub issues.


> I would like to argue
> that it would be beneficial for end-users to see the C++ standard
> minimum level for all libraries, even for those which work at the
> C++98/03 level on up. I do not understand the purpose of a library which
> does not wish to peg itself at a particular minimum C++ level.
>

At least one library supports *any* C++ level. Even those before C++98.
Please don't put a one dimensional straightjacket on this. What should such
libraries do?

PS. That one library happens to be my library, Predef.

--
-- René Ferdinand Rivera Morell
-- Don't Assume Anything  -- No Supone Nada
-- Robot Dreams - http://robot-dreams.net

_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
Reply | Threaded
Open this post in threaded view
|

Re: Boost website changes and .'cxxstd'

Boost - Dev mailing list
On 1/6/2021 3:10 PM, René Ferdinand Rivera Morell via Boost wrote:

> On Wed, Jan 6, 2021 at 2:02 PM Edward Diener via Boost <
> [hidden email]> wrote:
>
>>
>> If an end-user does not see a "C++ standard minimum level" for a library
>> in the documentation what should he/she assume ?
>
>
> They should *not* assume any particular level. And perhaps ask the author
> to indicate what the support is by filling GitHub issues.

The trouble with this is that there are about 110 libraries with no
'cxxstd' JSON attribute at all and we are asking programmers to go back
to guessing what the C++ standard minimum level is for those libraries.
I am really trying to give end-users information rather than going back
to guessing or having to ask about it each time.

>
>
>> I would like to argue
>> that it would be beneficial for end-users to see the C++ standard
>> minimum level for all libraries, even for those which work at the
>> C++98/03 level on up. I do not understand the purpose of a library which
>> does not wish to peg itself at a particular minimum C++ level.
>>
>
> At least one library supports *any* C++ level. Even those before C++98.
> Please don't put a one dimensional straightjacket on this. What should such
> libraries do?
>
> PS. That one library happens to be my library, Predef.

You added "cxxstd": "98" for predef. What is wrong with that ? It
basically says "any" C++ level. I would also argue that "03" essentially
say "any" C++ level, because how many programmers are using C++ before
it was standardized and how many programmers can distinguish between
C++98 and C++03 ? But I have no beef with "98" since that is what is
there. You are arguing that showing nothing is somehow better than
showing something, and I admit I do not see that.




_______________________________________________
Unsubscribe & other changes: http://lists.boost.org/mailman/listinfo.cgi/boost
123