boostorg/website

The boost website.

The boost website.

This is the source code for the boost website. It's automatically updated from the master branch. The beta website is available for testing and experiments, and is automatically updated from the beta branch.

If you want to edit the website, or run it locally, see the guide to updating the website.

To add to the release notes, create a pull request for the appropriate file in the history directory. You can preview the release notes for upcoming releases at the in progress release page. This is updated once an hour.

website's Issues

Collaboration/Communcation area of C++ Slack Workspace should be more prominent on the website

C++ Slack Workspace is for collaboration and communication within the community and interested users.
Currently, you need to perform archeology on the Boost website to find it mentioned somewhere (after some other boost library mentioned it). As far as I understand it, many (or several) boost libraries are using this C++ Slack Workspace.

RELATED RESOURCE: https://cppalliance.org/slack/

FOUND WHERE: Context of Beast Library changes on this page

• https://www.boost.org/users/history/version_1_70_0.html

DESIRED CHANGE:
Mention it near Wiki or Mailing List or on the FAQ page or community related resources.

Unnecessary redirections of website

Two days ago a Hacker News user reported a problematic behavior for the website and indeed was behaving weird.

Today, out of curiosity I decided to test it via curl and can see unnecessary redirections that could be resolved to https://www.boost.org/.

Here is what I currently see via terminal:

stefanos@debian:~ $ curl -IL http://boost.org
HTTP/1.1 301 Moved Permanently
Date: Thu, 05 May 2022 22:05:27 GMT
Server: Apache/2.2.15 (CentOS)
Location: https://boost.org/
Connection: close
Content-Type: text/html; charset=iso-8859-1

HTTP/1.1 301 Moved Permanently
Date: Thu, 05 May 2022 22:05:29 GMT
Server: Apache/2.2.15 (CentOS)
Location: http://www.boost.org/
Connection: close
Content-Type: text/html; charset=iso-8859-1

HTTP/1.1 301 Moved Permanently
Date: Thu, 05 May 2022 22:05:29 GMT
Server: Apache/2.2.15 (CentOS)
Location: https://www.boost.org/
Connection: close
Content-Type: text/html; charset=iso-8859-1

HTTP/1.1 200 OK
Date: Thu, 05 May 2022 22:05:31 GMT
Server: Apache/2.2.15 (CentOS)
Accept-Ranges: bytes
Connection: close
Content-Type: text/html; charset=UTF-8

codestyle

Please, create a webpage with descriptive common coding style guidelines.
Include there naming conventions.
Add rule that every name must have closest semantic meaning to its inner content in this set of libraries.

Improve accessibility in the search UI

Whilst the search UI works for screen readers, it could definitely be improved with the following changes:
Firstly, make the "Search" combobox a required field.
Secondly, there is no easy way of navigating through results. I ended up tabbing though links, but it is then unclear when a new search result refers to a different library.
Finally, could this be made a modal dialog. Screen readers have two ways of navigating the web.
One essentially "flattens" the page in to a buffer so it can be read easily. Tyhe other, which is what we are dealing with here is used in a "live environment" where you have contents that change.

To fix this, we should either have a set of headings for each library the search has found, or have the user actually click a search button rather than the search being automatic.

Contributing docs refer to svn.boost.org

[ taken from a post on the the boost developer's mailing list by Alain Miniussi ]

Hi,

I sometime need to contribute to boost but it is clearly not a regular activity.
And each time it takes me an unreasonable amount of time just to find the relevant git clone command.

I would like to know if something is inherently wrong with:

1. go to www.boost.org
2. unfold the "Development" menu on the right
3. hope to find the information regarding the development cycle

right now, these sections mostly contains pages with link the the wiki, which is expected to be at svn.boost.org which cannot be reached.

If the information is actually at https://github.com/boostorg/wiki/wiki/Getting-Started%3A-Overview (thanks you stackoverflow) why isn't that page referenced from https://www.boost.org/development/index.html or https://github.com/boostorg/boost ?

Todo in release notes (1.69.0)

Section: New Libraries

Outdated links to SGI Technical Resources

The website contains a few links to SGI Tech Archive Resources which has now been retired. These links should either be removed or replaced (I suggest en.cppreference.com). I will be happy to send a PR if the devs approve.

Boost.Build documentation link broken

In the getting started section. There is a link to the boost build documentation that is giving me a 404 file not found error.

In documentation, the link of new version notification should actually point to the new version

Google often returns links to outdated versions of the boost documentation. When opening a page, there appears a banner hinting to a new version of the documentation. However, this link is sometimes pointing to the start page, instead of the new version. For example:

Google returned: https://www.boost.org/doc/libs/1_46_1/libs/math/doc/sf_and_dist/html/math_toolkit/dist/dist_ref/dists/binomial_dist.html

The notification points to: https://www.boost.org/doc/libs/

It should point to: https://www.boost.org/doc/libs/1_70_0/libs/math/doc/html/math_toolkit/dist_ref/dists/binomial_dist.html

It would be even better to have a drop-down menu that allows to select the boost version one is using. I think, CMake does this really well (upper left corner): Besides all the explicit versions, it also provides a selection for upcoming and latest version of the docs.

Provide tar.xz source downloads

Hi!

tar.xz is smaller than tar.bz2 - see https://en.wikipedia.org/wiki/Xz . Please provide such downloads.

SVG files in docs invisible.

It appears SVG files, through references or directly, are not getting returned (or are missing). For example this SVG http://www.boost.org/doc/libs/1_58_0/libs/math/doc/equations/hyperexponential_pdf.svg gives a 404. Yet it's in the math docs https://github.com/boostorg/math/blob/master/doc/equations/hyperexponential_pdf.svg

See also SO: http://stackoverflow.com/questions/31503752/boost-documentation-images-not-appearing

Does anyone know the history behind the Font Denmark?

Hi,

Sorry to be the one to ask the "Question" that no-one will be able to answer, but I gotta.
Does anyone know the history / original author / download location of the Denmark font?
I've dug around the mailing list and have found a few leads, but no solid answer.

Google searches across the font domains (Font Squirrel and the alike) just say it's free, but offer no details.

Could someone ping Zoltan “cad” Juhasz and see if he can recall?
Thanks,

Auto generated date is missed in The Boost.Iterator Library documentation

The Boost.Iterator Library documentation for some unknown reason has "date" field.

It was last time set to a valid value (or at least it contained the date too) is 1.55.0

Maybe it should be either fixed or hardcoded or removed?

doc spelling mistake

in https://www.boost.org/users/history/version_1_68_0.html:
Fusion:
Fixed unintentional MPL placeholder substituion bug on fusion::transform (#5490).

'substituion' should be 'substitution'?

Link to the github repo from boost.org

boost.org is extremely frustrating.
Navigate to boost.org, and try to find the link to the github repositories.

It teases you link a lot of documentation on how git works, but never actually links you to the github repo.

Trying to download the latest sources from the website results in a "Forbidden" error.

Whenever I click on the "Download" link on the main boost.org web-site, I get the page shown in the screenshot below. It doesn't matter which browser I use, either.

Add links to GitHub downloads

It would be nice to add GitHub download links in release notes starting with Boost 1.81.0.

For example, on 1.81.0 release notes page, add a text like "Source packages with git layout are available on GitHub." below the downloads table in the Downloads section.

The archives on GitHub are useful for people using Boost in CMake. They lack the unified boost include directory and require the user to either recreate it by running b2 headers or specify library include directories in the compiler command line (which is what CMake does).

cobalt 1.84 documentation flowchart render error: Failed to generate image: mmdc failed

error in flowchart:

Failed to generate image: mmdc failed:
Error: Failed to launch the browser process!
/root/.cache/puppeteer/chrome/linux-1108766/chrome-linux/chrome: error while loading shared libraries: libatk-1.0.so.0: cannot open shared object file: No such file or directory


TROUBLESHOOTING: https://pptr.dev/troubleshooting

    at Interface.onClose (file:///root/.nvm/versions/node/v18.18.1/lib/node_modules/@mermaid-js/mermaid-cli/node_modules/@puppeteer/browsers/lib/esm/launch.js:253:24)
    at Interface.emit (node:events:529:35)
    at Interface.close (node:internal/readline/interface:534:10)
    at Socket.onend (node:internal/readline/interface:260:10)
    at Socket.emit (node:events:529:35)
    at endReadableNT (node:internal/streams/readable:1368:12)
    at process.processTicksAndRejections (node:internal/process/task_queues:82:21)


flowchart TD
    aw{await_ready?}
    aw ---->|true| ar[await_resume]
    aw -->|false| as[await_suspend]
    as -->|Resume| ar

https://www.boost.org/doc/libs/1_84_0/libs/cobalt/doc/html/index.html#awaitables

also reported here: boostorg/cobalt#146

No more roadmap?

I am not sure if this is the correct place, but I was wondering if boost will have a roadmap (like it used to have svn.boost.org - roadmap) on git now, or somewhere on their website, with estimates on when new versions are coming out.

Add testimonials to the Dawes memorial page

The following testimonials were submitted (a long time ago), but never got added to the memorial page for Beman: https://www.boost.org/users/memoriam/beman_dawes.html

I think page has testimonials are sorted by last name.

Niall Douglas: Beman had an unusually large impact on C++ over his long and very productive life. My personal opinion of his most monumental achievement was getting Filesystem into standard C++, which was probably the most tortuous, lengthy, and difficult library to have ever been standardised (to date), and that followed a preceding tortuous, lengthy and difficult Boost peer review involving multiple redesigns of the proposed library. Beman was on WG21 from nearly the beginning, served as the Library Working Group chair for some time, and was one of the original cofounders of the Boost C++ Libraries. He also had a long history of continuous contributions to open source, starting from when many on r/cpp were still children.

Christopher Kormanyos: When the evolution from Fortran to C to C++ was on, progress seemed to hit a snag around the turn of the century. Beman's innovative, comprehensive and reliable work on C++ and Boost helped get C++ back on track. I feel that he enlightened the era and inspired other pioneers of that time and beyond, transforming C++ into the powerful, expressive language it is today.

David Sankel: I had the opportunity to interact with Beman at both BoostCon and the Standardization committee. He was an incredibly reasonable, and nurturing person. Boost and the greater C++ community is indebted to his tremendous legacy.

Andrey Semashev: Although I haven't known Beman in person, I feel in debt to him for his role in Boost and C++ in general. The Boost Project and the community around it were most educational and inspiring, which allowed me to grow as a developer over the years. His libraries, such as Boost.Filesystem and Boost.System, have helped countless users and made it into the C++ standard as fundamental library components. He has been a long member of the C++ Standards Committee and chaired the Library Working Group. One of the most influential people in the C++ world, he will be missed.

Bjarne Stroustrup and Herb Sutter: https://isocpp.org/blog/2020/12/remembering-beman-dawes

Question/possible bug wrt the way doc lists are generated

Good day, when I tried to analyze an issue in boostorg/geometry (boostorg/geometry#585) I attempted to understand how https://www.boost.org/doc/generate.php?page=libs/libraries.htm&version=... works by running the website locally. As far as I understand, the generated/libraries.txt is generated by site-tools/update-doc-list.php from a mirror of the repositories and the resulting data is the same as what can be found in https://www.boost.org/doc/libraries.xml.

Looking at https://www.boost.org/doc/libraries.xml , I noticed that the final entry for geometry/extensions, that is not develop, is for version 1.70 . In the next version, the metadata was deleted ( https://github.com/boostorg/geometry/blob/boost-1.71.0/extensions/meta/libraries.json ). The only workaround I came up with, was putting the metadata back in and adding the "hidden" status.

However, it seems counterintuitive to propose to mask metadata that has been deleted by putting it back in with the "hidden" attritube. It seems like a bug to me to generate an entry in a list, based on metadata that has already been deleted.

So my question would be, whether I understood the mechanism correctly (and whether the same mechanism that is used by doc/generate.php?page=libs/libraries.htm is ultimately responsible for what shows up in the docs), whether putting the metadata back in would be the correct way to solve that issue and whether the way deleted metadata is (not) handled should be considered a bug in boostorg/website.

DNS_PROBE_FINISHED_NXDOMAIN

Hello,

I am trying to reach https://www.boost.org/ from Germany, but it fails. I first thought it was a regional issue but using a VPN did not fix it.

In Mozilla firefox I get a message that asks me to check if my firewall blocks internet (my firewall is disabled)

In google-chrome the error is more explicit : DNS_PROBE_FINISHED_NXDOMAIN

For me the site is unreachable, but on https://www.isitdownrightnow.com/ it is reported as reachable

This post did not help me

Minimalist Jamroot file for boost.python gives 404

On this page, there is this link which is broken.
The link is contained in the sentence "Here is our minimalist Jamroot file. Simply copy the file and tweak use-project boost to where your boost root directory is and you're OK. "

Permission to Add Styling to Your Website

Hey There, I'm OutdatedGuy

• I have visited your website, and for an organization like you the website seems very much poor(No Offence).
• I would like to add styling and reform your website.

Please Let me work on it with basic Access.

Thanks 😊

unknown element gcse:searchbox-only on the home page

The search box markup code on the home page is probably obsolete. I regenerated it from scratch and I got a div.gcse-searchbox-only for placeholder.

Repository file material is too aggressively cached

Files served from the website which originate from submodules should have a shorter cache expiration. For example:
http://www.boost.org/doc/libs/develop/libs/beast/doc/html/

I believe these files have no cache expiration, or an expiration far into the future. We need the opposite, especially for develop, they should have a very short cache or not be cached at all. I think this is a setting for the HTTP headers.

"A printer-friendly PDF version of this manual is also available." is a lie

Many of "DocBook XSL Stylesheets V1.79.1" based documentation refers to pdf documentation.

For example https://www.boost.org/doc/libs/1_82_0/libs/type_traits/doc/html/index.html

While last update of such documentation was in v1.56.0 2014-08-14

Maybe it worth to find all such mentions and remove them if pdf documentation is no longer provided.

doc sample code cannot compile

In https://www.boost.org/doc/libs/1_68_0/doc/html/boost_process/tutorial.html#boost_process.tutorial.error_handling's Error section:
The original code:

std::error_code ec;
bp::system c("g++ main.cpp", ec);

I think it should be:

std::error_code ec;
bp::system("g++ main.cpp", ec);

Is boost.org expired or hacked?

boost.org now shows an ad page, with valid SSL certificate. CT log shows that the certificate was issued on 2022-05-03T00:00:00Z, together with www.boost.org and lists.boost.org. Whois of boost.org says the last update is 2022-05-03T11:02:10Z.

No New/Updated libraries listed in News for Boost releases

Since Boost 1.83.0, the news entries on the front page (https://www.boost.org/) and News page (https://www.boost.org/users/news/) have empty "New libraries" and "Updated libraries" lists, although there are actually libraries in both categories. For example, in 1.83.0, there is one new Compat library and 25 updated libraries in the release notes.

Boost 1.82.0 was the last release where the library lists were populated in the News.

test targets minimal/full should be removed from the documentation

They are unimplemented and misleading. I will submit a pull request.

Issue with Revised date on various pages

https://www.boost.org/community/gsoc.html on this page the revised date section on the footer shows an older date i.e. "Revised $Date: 2007-10-22 22:55:52 +0100 Mon, 22 Oct 2007) $" whereas the code for that page on GitHub has the revised date as "Revised $Date: 2020-05-12$".

Also in most of the pages, the revised date is not mentioned just the label is written "Revised $Date$"
some of these pages are:
https://www.boost.org/development/website_updating.html
https://www.boost.org/development/index.html
https://www.boost.org/users/uses.html

Getting started page suggests invalid option --with-libraries

The UNIX getting started page (https://www.boost.org/doc/libs/1_73_0/more/getting_started/unix-variants.html), point 5.1, suggests that invoking b2 --with-libraries= should work, which is not true.

The page also suggests on point 5.2.4, in the note, to use output redirection to reduce verbosity, which could be replaced by options like -d0, which output errors, at least.

"Report Issue" search UI link should bring you to https://github.com/boostorg/website/issues

Right now it brings you to https://github.com/boostorg/website which is not quite as good.

Bad links in header and index

Clicking on the C++ Coding standards link redirects you to some kind of gambling website, and clicking on Herb Sutter does not take you to his current website.

Condensed listing of all libraries

Besides the "All | Categorized | Standard Proposals | TR1 libraries" views of libraries for any given release I would like to see a Condensed listing of all libraries which matched the "Libraries Listed Alphabetically" for each actual Boost distribution. This would enable the quick finding of any individual library's documentation from the online website. Right now with the "All" listing you have to scroll through many pages to find the library in which you are interested. The idea would be to change "All | Categorized | Standard Proposals | TR1 libraries" to "All | Categorized | Condensed | Standard Proposals | TR1 libraries" and the Condensed tab would then match how the "Libraries Listed Alphabetically" are displayed.

I would submit a PR for this but figuring out how this gets generated is beyond my efforts.

Table of content links to the old Wiki

The Welcome section of the table of content links to the Wiki as follows:

<li><a href="https://svn.boost.org/trac/boost/" class=
    "external">Wiki<span class="link">&gt;</span></a></li>

Can we improve it applying one of these?

• Point the link to https://github.com/boostorg/boost/wiki/
• Have "Wiki" and "Old Wiki" separately
• Remove the Wiki link completely

Request for Restructuring and Redesigning Website

The structure and design used in the website is very poor considering the standard of this organization. I would love to contribute to this organization, restructure and redesign it. If the community would want we can change the whole backend to Node.js. Or else we can restructure using php itself. I am good with both the languages and its structures. This organization needs a really good website to list out all our libraries and keep it organized and professional. Hoping a positive response. Glad to work with all of you.

Consistently declare UTF-8 encoding if possible

I happened to notice that Boost.org and beta.boost.org give somewhat contradictory encoding indications, and at odd with what I understand are modern best practices.

For production boost.org, the HTTP content-type header specifies charset=UTF-8, while the HTML meta-tag contentt-type specifies charset=us-ascii. As tested on a clean copy of Firefox [58, on Win 8.1 Pro x64], the assumed encoding is UTF-8. On the other hand, beta.boost.org has no charset specified in the HTTP content-type header, while the HTML meta-tag content-type remained us-ascii. Firefox thus assumes Windows-1252 (!). (These were tested on both the main page and the website development page, with the same results).

Therefore, while I'm no expert, it would seem best to just declare UTF-8 explicitly everywhere if possible, as is the modern best practice generally, and avoid any potential for trouble down the road. Unfortunately I've no experience with the particular static site generator boost.org uses, but I can't imagine it would be terribly complex to do unless there are other lingering encoding issues you all are aware of and I'm not (which may well be the case). Thanks!

Dead link in getting started guide.

Apologies if this is not the right place to report this.

In section 5.2.4 of Geting Started
There is a dead link to Boost.Build documentation.

Missing image in documentation

Online documentation for Boost is missing an image. See the screenshots below. Perhaps double check if this is also a missing image for older versions of Boost documentation and fix those too.

C++ committee info page says to contact Beman

website/community/committee.html

Lines 50 to 51 in 3dabd99

	who are active on the committee can help smooth the way. Contact
	Beman Dawes for more information.</p>

Download fails with "Forbidden"

On https://www.boost.org/users/download/#live the links to download all give 'Forbidden', eg https://dl.bintray.com/boostorg/release/1.72.0/source/boost_1_72_0.tar.bz2.

Container Hash is duplicated in libraries list

Try to find "Container Hash" library here https://www.boost.org/doc/libs/1_82_0/

It is listed twice in any category and any sorting option.

At first I thought that it is some kind of naming conflict, where several libraries are named "Container Hash", authored by Daniel James, added since 1.33.0, links to the same documentation page...

But no, it is obviously duplicated in the library list somehow.

I tried to find if any other library copied meta/libraries.json from Container Hash, but didn't find any. At least in master version of boost repository here on github. Maybe it was already found and fixed.

No brief changes description for Boost 1.83 in "News"

It is:
Version 1.83.0
New Libraries: Updated Libraries:
August 11th, 2023 16:23 GMT

Should Be:
Version 1.83.0
New Libraries: Compat Updated Libraries: Any, Atomic, Chrono, Compat, Core, DLL, Filesystem, Flyweight, Geometry, Iterator, JSON, Locale, Log, Math, Mp11, Multi-index Containers, Multiprecision, MySQL, Ratio, Test, Timer, Unordered, URL, UUID, Variant2
August 11th, 2023 16:23 GMT

Update changelog of boost-1.69 about symbol visibility change

Hi all,

Could you update the Changelog for this PR? boostorg/boost#190
It enables hidden visibility by default, which is a breaking change for me.

I think it's merged since 1.69. Didn't see it mentioned in the Changelog: https://www.boost.org/doc/libs/1_71_0/libs/log/doc/html/log/changelog.html

Thanks,
Quanlong

View as text on the wiki is broken

To repeat:

1. Go to https://svn.boost.org/trac/boost/wiki/SoCSubmissionTemplate.
2. At the bottom of the page where it says "Download in other formats" choose "Plain text".
3. Witness the explosion:

The response from the server contained duplicate headers. This problem is generally the result of a misconfigured website or proxy. Only the website or proxy administrator can fix this issue.
Error code: ERR_RESPONSE_HEADERS_MULTIPLE_CONTENT_DISPOSITION

Niall

Site is broken

Currently site https://www.boost.org/ is broken.

Old boost version documentation not available.
Current boost version documentation is partially broken.