boost.uuid typo error

older
Platform independent memory mapped...

niXman

21 Nov 2011 21 Nov '11

4:33 p.m.

Hello list! In the docmantation for boost.uuid on this link: http://www.boost.org/doc/libs/1_48_0/libs/uuid/uuid.html#Stream_operators in the example of usage boost::lexical_cast<> with boost::uuids::uuid: boost::uuids::uuid u1; // initialize uuid std::string s = boost::lexical_caststd::string(u); // <<<<<<<<<<<< must be u1 boost::uuids::uuid u2 = boost::lexical_castboost::uuids::uuid(s); assert(u1 == u2); I wish that boost documentation was famous as well as Qt documentation ;) Regards, niXman.

Show replies by date

Paul A. Bristow

21 Nov 21 Nov

4:59 p.m.

...

-----Original Message----- From: boost-users-bounces@lists.boost.org [mailto:boost-users-bounces@lists.boost.org] On Behalf Of niXman Sent: Monday, November 21, 2011 4:34 PM To: boost-users@lists.boost.org Subject: [Boost-users] boost.uuid typo error

Hello list!

In the docmantation for boost.uuid on this link: http://www.boost.org/doc/libs/1_48_0/libs/uuid/uuid.html#Stream_operators in the example of usage boost::lexical_cast<> with boost::uuids::uuid: boost::uuids::uuid u1; // initialize uuid

std::string s = boost::lexical_caststd::string(u); // <<<<<<<<<<<< must be u1 boost::uuids::uuid u2 = boost::lexical_castboost::uuids::uuid(s);

assert(u1 == u2);

I wish that boost documentation was famous as well as Qt documentation ;)

It's just this sort of 'featurette' that Quickbook snippets allow authors to avoid - by including only stuff that compiles (and perhaps also runs). And if you change the source code, the example changes too - without updating the original test.. You can also easily include snippets of the output too. Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com

Andy Tompkins

10:02 p.m.

On Monday, November 21, 2011 4:59 PM, "Paul A. Bristow" wrote:

...

...
-----Original Message----- From: boost-users-bounces@lists.boost.org [mailto:boost-users-bounces@lists.boost.org] On Behalf Of niXman Sent: Monday, November 21, 2011 4:34 PM To: boost-users@lists.boost.org Subject: [Boost-users] boost.uuid typo error

Hello list!

In the docmantation for boost.uuid on this link: http://www.boost.org/doc/libs/1_48_0/libs/uuid/uuid.html#Stream_operators in the example of usage boost::lexical_cast<> with boost::uuids::uuid: boost::uuids::uuid u1; // initialize uuid

std::string s = boost::lexical_caststd::string(u); // <<<<<<<<<<<< must be u1 boost::uuids::uuid u2 = boost::lexical_castboost::uuids::uuid(s);

assert(u1 == u2);

I wish that boost documentation was famous as well as Qt documentation ;)

It's just this sort of 'featurette' that Quickbook snippets allow authors to avoid - by including only stuff that compiles (and perhaps also runs).

And if you change the source code, the example changes too - without updating the original test..

You can also easily include snippets of the output too.

Paul

--- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com

Thanks. I will fix the documentation. It is on my todo list to change the docs to Quickbook. It will likely be awhile yet, only because I haven't spent the (likely minimal) time to put it on my machine and learn it. It there a small sample that I could start with, instead of starting from scratch? I started with the sample html documentation from boost for what is currently there for boost::uuids. Thanks again, Andy Tompkins

Kerry, Richard

22 Nov 22 Nov

10:33 a.m.

Quickbook appears to be accounting software...... I presume that's not the right one. I'm generally looking into documentation systems. Can someone provide the right link to find out more about this Quickbook (which I presume is something to do with documentation). Appreciatively, Richard.

...

-----Original Message----- From: boost-users-bounces@lists.boost.org [mailto:boost-users-bounces@lists.boost.org] On Behalf Of Andy Tompkins Sent: 21 November 2011 22:02 To: boost.org; boost.org Subject: Re: [Boost-users] boost.uuid typo error

On Monday, November 21, 2011 4:59 PM, "Paul A. Bristow" wrote:

...
...
-----Original Message----- From: boost-users-bounces@lists.boost.org [mailto:boost-users-bounces@lists.boost.org] On Behalf Of niXman Sent: Monday, November 21, 2011 4:34 PM To: boost-users@lists.boost.org Subject: [Boost-users] boost.uuid typo error

Hello list!

In the docmantation for boost.uuid on this link:

http://www.boost.org/doc/libs/1_48_0/libs/uuid/uuid.html#Strea m_operators

...
in the example of usage boost::lexical_cast<> with boost::uuids::uuid: boost::uuids::uuid u1; // initialize uuid

std::string s = boost::lexical_caststd::string(u); // <<<<<<<<<<<< must be u1 boost::uuids::uuid u2 = boost::lexical_castboost::uuids::uuid(s);

assert(u1 == u2);

I wish that boost documentation was famous as well as Qt documentation ;)

It's just this sort of 'featurette' that Quickbook snippets allow authors to avoid - by including only stuff that compiles (and perhaps also runs).

And if you change the source code, the example changes too - without updating the original test..

You can also easily include snippets of the output too.

Paul

--- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com

Thanks. I will fix the documentation.

It is on my todo list to change the docs to Quickbook. It will likely be awhile yet, only because I haven't spent the (likely minimal) time to put it on my machine and learn it. It there a small sample that I could start with, instead of starting from scratch? I started with the sample html documentation from boost for what is currently there for boost::uuids.

Thanks again, Andy Tompkins _______________________________________________ Boost-users mailing list Boost-users@lists.boost.org http://lists.boost.org/mailman/listinfo.cgi/boost-users

Paul A. Bristow

noon

...

-----Original Message----- From: boost-users-bounces@lists.boost.org [mailto:boost-users-bounces@lists.boost.org] On Behalf Of Kerry, Richard Sent: Tuesday, November 22, 2011 10:34 AM To: boost-users@lists.boost.org Subject: Re: [Boost-users] boost.uuid typo error

Quickbook appears to be accounting software...... I presume that's not the right one.

I'm generally looking into documentation systems. Can someone provide the right link to find out more about this Quickbook (which I presume is something to do with documentation).

http://www.boost.org/doc/libs/1_48_0/doc/html/quickbook.html is the best starting point. Rebuilding existing docs - and studying how they do things - is a good starting point. Paul --- Paul A. Bristow, Prizet Farmhouse, Kendal LA8 8AB UK +44 1539 561830 07714330204 pbristow@hetp.u-net.com

4741

Age (days ago)

4742

Last active (days ago)

List overview

Download

4 comments

4 participants

participants (4)

Andy Tompkins
Kerry, Richard
niXman
Paul A. Bristow