Quantcast

Fwd: [outcome] Tutorial third rewrite finished (I hope)

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
1 message Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Fwd: [outcome] Tutorial third rewrite finished (I hope)

Boost - Dev mailing list
Looks like boost-dev wasn't working yesterday, so resending this.

-------- Forwarded Message --------
Subject: [outcome] Tutorial third rewrite finished (I hope)
Date: Sat, 4 Mar 2017 09:28:51 +0000
From: Niall Douglas <[hidden email]>
To: [hidden email]

I know the Safe Numerics review is currently happening and almost
straight thereafter comes the final Stacktrace review so people are
probably a bit tired of reviewing stuff, however I believe the third
rewrite of the Outcome tutorial is now finished at long last.

Expected<T, E> in Context:
https://ned14.github.io/boost.outcome/md_doc_md_02-tutorial_a.html

Expected<T, E> in Practice:
https://ned14.github.io/boost.outcome/md_doc_md_03-tutorial_b.html

Refining Expected<T, E>:
https://ned14.github.io/boost.outcome/md_doc_md_04-tutorial_c.html

Feedback is once again very welcome, indeed this tutorial looks so very
different from the previous two editions because of your feedback, so
thank you.

In case anyone is interested, the biggest showstopper remaining before
this goes into the Boost review queue is the reference docs: doxygen
chokes badly on the preprocessor metaprogramming Outcome uses and
generate rubbish docs. I didn't find much success with Standardese or
Doxypress either, so I'm currently working with my shiny new Python C99
conforming preprocessor (https://github.com/ned14/pcpp) to partially
preprocess Outcome into a form doxygen can cope with. I expect a few
weeks remain on that, it may pass most of the C11 preprocessor torture
test suite but the partial preprocessor pass through implementation has
bugs I'm still nailing down :)

Niall

--
ned Productions Limited Consulting
http://www.nedproductions.biz/ http://ie.linkedin.com/in/nialldouglas/


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