[LSC] Proposed change to LDraw part file header to support the CA
-Version3
VIVAN Guy
guy_vivan at infonie.fr
Tue Aug 22 15:23:08 EDT 2006
Hi all ;o)
I have few questions concerning the shaping of header for the pre-character
“!”:
1) Who of the author or the administrator has to add the pre-character
"!"
Because at present MLCAD does not make it and already that he modifies lines
"BFC INVERTNEXT" by "BFC CERTIFY INVERTNEXT". We are (author of parts) to
oblige to use a notepad to correct it every time we modify a file with
MLCAD.
2) The other utilities as LDVIEW and L3p know how to interpret the
command « 0! BFC CERTIFY CCW » ?
And in your example, you not used this pre-charactere ???
0 Technic Connector0 Name: 3651.dat0 Author: James Jessiman0 LDRAW_ORG Part
UPDATE 2006-010 LICENSE Redistributable under CCAL version 2.0 : see
CAreadme.txt
0 BFC CERTIFY CCW0 HISTORY 2000-08-?? {Axel Poque} fixes to resolve L3P
error messages0 HISTORY 2000-08-?? {Manfred Moolhuysen} fixes to resolve L3P
error messages0 HISTORY 2002-04-25 [PTadmin] Official update 2002-020
HISTORY 2004-05-18 [guyvivan] Made BFC compliant0 HISTORY 2004-05-18
[guyvivan] Use more primitive0 HISTORY 2006-??-?? [PTadmin] Official update
2006-01Else I agree.
Guy
----- Original Message -----
From: "LDraw" <ldraw at holly-wood.it>
To: "LDraw Standards Committee" <lsc at ldraw.org>
Sent: Tuesday, August 22, 2006 8:09 PM
Subject: [LSC] Proposed change to LDraw part file header to support the
CA -Version3
> dear LSC members,
>
> to speed up things I summarized this thread
> http://five.pairlist.net/pipermail/lsc/2006-August/000415.html and the
> follow-ups in a new version, trying to interpret the mood withing the LSC
> for certain changes.
>
> the most significant changes are:
>
> * pre-character ! on all metas except for the 0 Name: and 0 Author: tag
> * keywords and category added
> * history still part of the change despite the discussion to remove it. (I
> like the idea of honoring peoples efforts in the parts they worked on. it
> would require to be online to read the history tags - I'm 99% ofline when
> working on parts an I find the information in the history useful)
>
> thx, w.
>
>
> ps. I know the LSC is NOT my territory but we need the new header as quick
> as possible.
>
>
>
>
> Proposed changes to the LDraw part header to support the Contributor
> Agreement
>
> The following shortcomings in the current LDraw part header require
> attention to support the Contributor Agreement :
>
> a) The author line fails to identify the LDraw.org username – the basis
> upon which CA affirmation is assessed.
> b) The header does not identify whether the part is covered by the
> Contributor Agreement or not.
> c) The change history comment lines are unstructured and fail to clearly
> identify the LDraw.org username.
> d) The header is not conform to the new meta command syntax
> e) The header fails to clearly identify unofficial parts
>
>
>
> The proposed new structure for official parts is :
>
> 0 PartDescription
> 0 Name: Filename.dat
> 0 Author: RealName [UserName]
> 0 !LDRAW_ORG Part|Subpart|Primitive|48_Primitive UPDATE YYYY-RR
> 0 !LICENSE Redistributable under CCAL version 2.0 : see CAreadme.txt
> or
> 0 !LICENSE Not redistributable : see NonCAreadme.txt
>
> 0 !CATEGORY Categoryname
> 0 !KEYWORDS words, more words,…,
> 0 !KEYWORDS words in second row, …, final words
>
> 0 !BFC ( CERTIFY ( CCW | CW ) | NOCERTIFY )
>
> 0 !CMDLINE LDraw run-time command(s)
>
> Where
> PartDescription is the descriptive name of the part
> Filename is the file name
> RealName is the author’s real name
> UserName is the author’s LDraw username. it needs to be
> optional for those past authors that don't have a PT username
> YYYY-RR is the LDraw update year and release within year
> and the square brackets are included in the file to indicate LDraw
> usernames.
>
> For example:
>
> 0 Animal Scorpion
> 0 Name: 30169.dat
> 0 Author: Chris Dee [cwdee]
> 0 !LDRAW_ORG Part UPDATE 2006-01
> 0 !LICENSE Redistributable under CCAL version 2.0 : see CAreadme.txt
>
> 0 !CATEGORY Animal
> 0 !KEYWORDS Sting, Poison, Adventurers, Egypt
>
> 0 !BFC CERTIFY CW
>
> or
>
> 0 Boat Base 8 x 10
> 0 Name: 2622.dat
> 0 Author: Chris Alano
> 0 !LDRAW_ORG Part UPDATE 2000-02
> 0 !LICENSE Not redistributable : see NonCAreadme.txt
>
> 0 !CATEGORY Boat
> 0 !KEYWORDS Pirates, Caribbean, Ship
>
> 0 !BFC NOCERTIFY
>
> For the change history, I’m proposing a “0 !HISTORY” meta-statement:
>
> 0 !HISTORY YYYY-MM-DD [UserName] Free text description of change
> or
> 0 !HISTORY YYYY-MM-DD {RealName} Free text description of change
>
> I’d also like the release process to automatically add lines to this when
> a part is made official – at present it is unclear which changes are
> included in which version of the file.
>
> For example, this,
>
> 0 Technic Connector
> 0 Name: 3651.dat
> 0 Author: James Jessiman
> 0 Official LCAD Part - 2000-02 Update
> 0 2000-Aug Axel Poque, Manfred Moolhuysen - fixes to resolve L3P error
> messages
>
> 0 // 2004-05-18 GuyVivan Made BFC compliant
> 0 // 2004-05-18 GuyVivan Use more primitive
>
> 0 BFC CERTIFY CCW
>
> would, when next released become :
>
> 0 Technic Connector
> 0 Name: 3651.dat
> 0 Author: James Jessiman
> 0 !LDRAW_ORG Part UPDATE 2006-01
> 0 !LICENSE Redistributable under CCAL version 2.0 : see CAreadme.txt
>
> 0 !CATEGORY Technic
> 0 !KEYWORDS Being a Classic Space, Western, Adventurer I can't
> 0 !KEYWORDS think of any Technic Keywords
>
> 0 !BFC CERTIFY CCW
>
> 0 !HISTORY 2000-08-?? {Axel Poque} fixes to resolve L3P error messages
> 0 !HISTORY 2000-08-?? {Manfred Moolhuysen} fixes to resolve L3P error
> messages
> 0 !HISTORY 2002-04-25 [PTadmin] Official update 2002-02
> 0 !HISTORY 2004-05-18 [guyvivan] Made BFC compliant
> 0 !HISTORY 2004-05-18 [guyvivan] Use more primitive
> 0 !HISTORY 2006-??-?? [PTadmin] Official update 2006-01
>
>
> I also propose to add full headers to the ~Moved to files and other admin
> generated files with a special name / username, probably “PTadmin”.
>
> As Travis pointed out the header fails to clearly identify if the file is
> a part, especially when they at the PT. I therefore suggest to modify the
> !LDRAW_ORG statement for PT-usage only as following:
>
> 0 !LDRAW_ORG Unofficial_Part| Unofficial_Subpart| Unofficial_Primitive
> |Unofficial_48_Primitive
>
> A syntax like "Unofficial Part", "Subpart_unofficial",
> "Unofficial_Element", "Non-official Part" would be rejected by the PT.
>
> 0 !HISTORY 2006-05-22 [PTadmin] Initial version
> 0 !HISTORY 2006-08-01 [PTadmin] Official update 2006-02
> 0 !HISTORY 2006-08-22 [Holly-Wood] Sum up of the current discussion, added
> unofficial statement,
> 0 !HISTORY 2006-08-22 [Holly-Wood] added exclamation mark, added keywords
> and category, made BFC compliant
> _______________________________________________
> LSC mailing list
> LSC at ldraw.org
> http://five.pairlist.net/mailman/listinfo/lsc
>
More information about the LSC
mailing list