- Boost - lists.boost.org

RE: [boost] Copyright and License in XML documentation
by Reece Dunn 30 Aug '04

30 Aug '04

Jeff Garland wrote: >I found a few moments to work on cleaning up licensing issues and decided >to >go make sure all the date_time xml docs have licensing info. The problem >is, >how should the copyright be added to all the files? I hunted around in >other >libraries using boostbook and it looks like they all lack copyright and >license info in all but the top level xml file. I notice that in the >library >main file we correctly notice the following construct in the inspection: > ><libraryinfo> > <author> > <firstname>Jeff</firstname> > <surname>Garland</surname> > </author> > > <copyright> > <year>2001</year> > <year>2002</year> > <year>2003</year> > <year>2004</year> > <holder>CrystalClear Software, Inc</holder> > </copyright> > > <legalnotice> > <para>Subject to the Boost Software License, Version 1.0. (See >accompanying file > <filename>LICENSE_1_0.txt</filename> or copy at <ulink > >url="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</ulink>)</para> > </legalnotice> > > <librarypurpose>A set of facilities to ease programming with dates and >times. > </librarypurpose> > <librarycategory name="category:misc"/> ></libraryinfo> This is so that the legal notice can be rendered in the introduction page of the library documentation. >So it seems one option would be to change the boostbook schema and allow >copyright and legal notice elements in each file. The other possibility >would >be to add this as a comment: > > > >Thoughts on how best to approach this? I think the best approach would be in a comment, since adding copyright markup to each file would require adding code in the XSLT files to prevent it from being rendered. Regards, Reece _________________________________________________________________ Use MSN Messenger to send music and pics to your friends http://www.msn.co.uk/messenger

3 2

VC8.0 and algorithm/string/replace failure
by Victor A. Wagner Jr. 30 Aug '04

30 Aug '04

I compiled replace_test with vs.net2005 and debugged it. It clearly throws an exception, and re-throws it later from the test framework, which causes the "ask to terminate abnormally" message. BUT............ the output window has the following in it _before_ the exception is thrown: error: list iterators incompatible, at g:\program files\microsoft visual studio 8\vc\include\list: 283 I'm not sure why it thinks the iterators are incompatible, but.... it might help the author(s) to have the above error mentioned in the failure log (I don't know why it's not there) Victor A. Wagner Jr. http://rudbek.com The five most dangerous words in the English language: "There oughta be a law"

4 7

[inspect] Status...
by Rene Rivera 30 Aug '04

30 Aug '04

Just updating on the current status from the inspection tests... 8105 files scanned 680 directories scanned 184 problems reported problem counts: 2 files with invalid line endings 0 bookmarks with invalid characters 1 invalid urls 72 broken links 46 unlinked files 59 file names too long 4 files with tabs Of interest in those... libs/thread/test/Jamfile: invalid (cr only) line-ending libs/graph/example/fibonacci_heap.cpp: tabs in file libs/range/test/partial_workaround.cpp: tabs in file libs/serialization/test/test_utf8_codecvt.cpp: tabs in file libs/spirit/test/distinct_tests.cpp: tabs in file 8105 files scanned 680 directories scanned 4397 problems reported problem counts: 2970 files missing Boost license info 1427 files missing copyrights -- -- Grafik - Don't Assume Anything -- Redshift Software, Inc. - http://redshift-software.com -- rrivera/acm.org - grafik/redshift-software.com - 102708583/icq

2 1

Re: Your copyright in the Boost C++ Libraries (second try)
by Christian Engström 30 Aug '04

30 Aug '04

I Christian Engström, give permission for all my contributions to Boost to be moved to the Boost Software License Version 1. Christian Engström John Maddock wrote: > Hi, if you are receiving this reminder again it is because there are > one or more > files in the Boost C++ libraries that contain your copyright declaration. > [...]

1 0

Fw: Your copyright in the Boost C++ Libraries (second try)
by John Maddock 30 Aug '04

30 Aug '04

And another permission: ----- Original Message ----- From: "Nicolai Josuttis" <nico(a)josuttis.de> To: "John Maddock" <john(a)johnmaddock.co.uk> Cc: <boost-owner(a)lists.boost.org> Sent: Sunday, August 29, 2004 2:44 PM Subject: Re: Your copyright in the Boost C++ Libraries (second try) > Hi John, > sorry for not answering immediately, but these > mails were considered as spam. > However,m this time I saw it. > > OK, here it is: > > I, Nicolai Josuttis, give > permission for all my contributions to Boost to be moved to the Boost > Software License Version 1. > > Best > Nico > > John Maddock wrote: > >> >> Hi, if you are receiving this reminder again it is because there are one >> or more >> files in the Boost C++ libraries that contain your copyright declaration. >> >> PLEASE, do take a little time to read through this and respond - it would >> help us a great deal! If you already have responded, then I missed it, >> and I apologise, but if you could take a little time to put me right, >> then that would be appreciated as well. >> >> As some of you will know already, in order to simplify Boost licensing, >> we >> are in the process of moving to a single common license >> (http://www.boost.org/LICENSE_1_0.txt) The aim of the new license is to >> provide a single wording, that encapsulates our previous license >> requirements, and which will simplify the evaluation of Boost for >> commercial >> organisations. >> >> So here's the big question: may we have permission to change code that >> has >> your copyright to use the new license? Your copyright declaration would >> obviously remain, it's only the license text that would change. >> >> If "yes", and you have Boost-cvs write access, please add your name to >> more/blanket_permission.txt. >> >> If "yes" and you have access to the Boost mailing list >> (boost(a)lists.boost.org) then please post a message there, subject "Boost >> License Permission", and content something like: "I Jim Hacker, give >> permission for all my contributions to Boost to be moved to the Boost >> Software License Version 1". (This gives us a public record that your >> permission has been given). >> >> If "yes", but you are no longer subscribed to the Boost list then please >> reply to boost-owner(a)lists.boost.org with content as above. >> >> If "no", please give us some idea what objections you may have. >> >> Finally, if this message was sent in error, please let us know, it's just >> about possible that we have you mixed up with someone of the same name, >> and >> if so apologies. >> >> Many thanks for your time, >> >> John Maddock. >> >> > > -- > Nicolai M. Josuttis http://www.josuttis.de/ > Solutions in Time mailto:nico@josuttis.de > phone: 0700 / 5678 8888 (international: +49 700 5678 8888) > 0700 / JOSUTTIS (international: +49 700 JOSUTTIS) > >

1 0

Nightly CVS docs broken?
by Vladimir Prus 30 Aug '04

30 Aug '04

The link to nightly CVS documentation on boost.org appears to be broken: it leads to http://www.boost.org/regression-logs/cs-win32_metacomm/doc/html/libraries.h… which generates an error. Is it possible to fix somehow? Thanks, Volodya

2 2

Re:Re: [boost] another bjam question
by Robert Ramey 30 Aug '04

30 Aug '04

John Maddock >> This indicates that the Microsoft native include is specified BEFORE the >> STLPort one. This would explain why the config_info doesn't reflect the >> STLPort usage. >> >> Can someone tell me what I should be doing differently? I don't know, but the dmc toolset is broken for the same reason. Actually this seems to me to be a bad design decision: why would the compilers include directory be present on the command line at all? If my compilers environment has been modified to place some other directory first (for example in vcvars32.bat) then why would bjam subvert that? I traced this to changes made at the beginning of august by Rene Rivera to factor out commonalities of stlport toolset. Basically not a bad idea but it ended up with this error. Rene is the best person to fix it if he's around. I sent him a private email but go no response. So I'm a little bit in holding pattern on this. Apparently there are some loose ends with the stlport/serialization library combination that I would like to resolve. Robert Ramey

2 1

Re:[boost] Review of Daryle Walker's "More IO" library begins today, August 21, 2004.
by Robert Ramey 30 Aug '04

30 Aug '04

Some general comments: First of all, let me say that I am a fan of Daryle's state-saver library. I have found it to be very useful. The documentation sections use the word "Rationale" where I think they should be using the word "Motivation". I see Motivation as the explanation why the library is useful in the first place. I see Rationale (plural) as a list of justifications for design choices. This is one library submission. However, it is really several almost disjoint or orthogonal parts. a) new io manipulators b) facilities for wrapping streambuf c) a couple of new kinds of streams These should be considered separately. Manipulators ============ Here is the first part of the documentation: Rationale There are several I/O manipulators that can be useful to a general audience besides the ones given in the Standard library. This header supplies some of them. Form-based Manipulator Header The header boost/io/iomanip_form.hpp contains a class template for multiple manipulations. Form-based Manipulator Objects from a boost::io::basic_ios_form template class represent manipulators that determine what and how to affect the standard I/O attributes via repeated calls to its member functions, then can change how a single insertion or extraction call happens for an streamable object. Said manipulators can be temporarily created (in-line, without a name) or created conventionally in advance for multiple insertions/extractions. On getting this far, I have no idea what these manipulators are supposed to do, what problem they are meant solve. Or when I would use them. I believe that this part of the manual should contain: Motivating example. Problem solved by form-based manipulators. A sort of Tutorial section. The line-skipping an repeated-char seem a little more understandable- if only because of their names. Repeated_char_narrow - I would think that the "narrowing" of characters might be something more commonly handled by codecvt facet. I would prefer that the html files be broken in smaller sections. Array Based Streams =================== Its not clear to me how this is functionally different from strstream Stream buffer implementations ============================= Stream buffer with variable size buffer Stream buffer which discards output Stream buffer which returns a constant value These I find understandable though I'm not sure what I would use them for - but that's not a criticism. The streams based on these buffers are small facilitators when don't have much code. OK. Stream buffer wrapper ===================== I gather this is to factor out common code for making new stream buffers. Actually, since I haven't made a streambuffer myself I don't know all of what's involved. I'll take your word that its useful. Overlap ======= I've also taken a forward look at Jon Turkanis coming offering. I see significant overlap. Jonathon's library is more ambitious in that it in that it addresses composition of stream buffer adaptors. I suspect it would include the above as subset. So - I'm going to recommend that the review manager for this library reserve judgment pending the upcoming review of the Jonathon's library. Ideally the two managers involved would coordinate their reviews so that functionality doesn't get duplicated. >What is your evaluation of the design? The design is a natural extension of standard C++ library and in principle I see no problems here. >What is your evaluation of the implementation? I didn't run the code, but it seems to follow standard convention - a good thing for a library like this. >What is your evaluation of the documentation? The documentation is pretty clear - as far as it goes. It needs more background, motivation, and tutorial like examples. >What is your evaluation of the potential usefulness of the library? >Did you try to use the library? With what compiler? Did you have any >problems? I didn't use the library. >How much effort did you put into your evaluation? A glance? A quick >reading? In-depth study? Just about 1-2 hours reviewing the documentation. >Are you knowledgeable about the problem domain? Fairly knowledgable >And finally, every review should answer this question: >Do you think the library should be accepted as a Boost library? Be sure to >say this explicitly so that your other comments don't obscure your overall >opinion. a) manipulators are probably OK - but they need more documentation to explain what they are to be used for. With these changes, I would expect to see them added to the io library. b) streambuffers. I believe that it premature to include these in Boost. I think this will be more clear after the upcoming review of Jon Turkanis library which has overlapping functionality. Robert Ramey

3 2

Java style GUI in C++
by Reece Dunn 29 Aug '04

29 Aug '04

I am currently designing a GUI framework in C++ (initially targeting the Windows platform) that uses a model similar to that which Java uses in it's AWT and Swing libraries. Specifically: [1] Being able to use constructors to create the windows/components. This means there is no need to explicitly call a Create method like in the MFC framework. [2] The use of layout managers. I like the various layout managers in Java and how easy it is to construct complex GUI interfaces. [3] The support for events via "listeners". This will most likely be geared towards key/mouse events and "action" events (e.g. when the user presses on a button). [4] Support for windowed and windowless components. Windowed components will use the native controls where possible, allowing a natural look and feel. Windowless controls will be lightweight components that do not use a native component (a Window handle on the Windows platform); these will be useful for writing the layout managers. At the moment, I have a basic working version that allows you to write the following: int PASCAL WinMain( HINSTANCE, HINSTANCE, LPSTR, int sw ) { swing::JFrame frame( L"Swing JFrame!" ); frame.setPane( new swing::JPanel()); frame.setSize( 500, 500 ); frame.show( sw ); MessageLoop msg; return( msg.Execute()); } This creates two windows: the main frame and a panel that is a child of that frame. The JFrame is created in the constructor, but is not displayed until show is called. Likewise, the JPanel is created inside its constructor and the JFrame.setPane method makes that window a child of the frame. I would appreciate comments and ideas as to what people would like out of a GUI framework, especially one that will be multi-platform. Regards, Reece _________________________________________________________________ It's fast, it's easy and it's free. Get MSN Messenger today! http://www.msn.co.uk/messenger

12 27

Copyright and License in XML documentation
by Jeff Garland 29 Aug '04

29 Aug '04

I found a few moments to work on cleaning up licensing issues and decided to go make sure all the date_time xml docs have licensing info. The problem is, how should the copyright be added to all the files? I hunted around in other libraries using boostbook and it looks like they all lack copyright and license info in all but the top level xml file. I notice that in the library main file we correctly notice the following construct in the inspection: <libraryinfo> <author> <firstname>Jeff</firstname> <surname>Garland</surname> </author> <copyright> <year>2001</year> <year>2002</year> <year>2003</year> <year>2004</year> <holder>CrystalClear Software, Inc</holder> </copyright> <legalnotice> <para>Subject to the Boost Software License, Version 1.0. (See accompanying file <filename>LICENSE_1_0.txt</filename> or copy at <ulink url="http://www.boost.org/LICENSE_1_0.txt">http://www.boost.org/LICENSE_1_0.txt</ulink>)</para> </legalnotice> <librarypurpose>A set of facilities to ease programming with dates and times. </librarypurpose> <librarycategory name="category:misc"/> </libraryinfo> So it seems one option would be to change the boostbook schema and allow copyright and legal notice elements in each file. The other possibility would be to add this as a comment:  Thoughts on how best to approach this? Jeff

1 0