We're following the format outlined in the boost docs. On Jun 27, 2010, at 9:51 AM, Andrei Alexandrescu wrote:
> I'm seeing this at the beginning of Phobos files: > > /** > * ... > * License: <a href="http://www.boost.org/LICENSE_1_0.txt";>Boost License > 1.0</a>. > * Authors: XYZ > * > * Copyright Digital Mars 2005 - 2009. > * Distributed under the Boost Software License, Version 1.0. > * (See accompanying file LICENSE_1_0.txt or copy at > * http://www.boost.org/LICENSE_1_0.txt) > */ > > I don't think we need two mentions of the license, and oftentimes the text > appears poorly formatted in the actual doc. I'm thinking of: > > /** > * ... > * License: $(WEB boost.org/LICENSE_1_0.txt, Boost License 1.0). > * Authors: XYZ > * > * Copyright Digital Mars 2005-. > */ > > I'm using the WEB macro to allow non-html doc generation later on, and also > am eliminating the closing year from the copyright. > > Walter - does this work? I'm preemptively doing this formatting on all files > I touch. > > > Andrei > _______________________________________________ > phobos mailing list > [email protected] > http://lists.puremagic.com/mailman/listinfo/phobos _______________________________________________ phobos mailing list [email protected] http://lists.puremagic.com/mailman/listinfo/phobos
