Return to canon.h CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / new / notes / src

Annotation of 43BSDTahoe/new/notes/src/canon.h, revision 1.1.1.1

1.1       root        1: /*
                      2:  *     The canonical form of a note looks like this:
                      3:  *
                      4:  *     N:<systemname>:<uniqid>:<resps>
                      5:  *     <title>
                      6:  *     <authorname>:<author uid>
                      7:  *     <year of note written>:<month>:<day>:<hour>:<minute>
                      8:  *     <status>:<length of text>
                      9:  *     <text>
                     10:  *
                     11:  *     the canonical form of a response looks like:
                     12:  *
                     13:  *     R:<note system>:<note id>:<response system>:<response id>:<resp #>
                     14:  *     <authorname>:<author id>
                     15:  *     <year of response written>:<month>:<day>:<hour>:<minute>
                     16:  *     <status>:<length of text>
                     17:  *     <text>
                     18:  *
                     19:  *     the file containing these forms will usually look like this:
                     20:  *
                     21:  *     <NOTE>
                     22:  *     <resp 1>
                     23:  *     <resp 2>
                     24:  *     ...
                     25:  *     <resp n>
                     26:  *     <NOTE>
                     27:  *     <NOTE>  (previous note had no responses)
                     28:  *     <resp 1>
                     29:  *     ...
                     30:  *     <resp m>
                     31:  *
                     32:  *     For network transmissions, the file of notes/responses 
                     33:  *     to be transmitted will be built
                     34:  *     locally, and then we will use someone elses packet mechanisms
                     35:  *     to transmit the data to the remote site. The remote will take
                     36:  *     care of checking to see if they already have copies of things.
                     37:  *
                     38:  *     The format of an ALMOST generic note, sent to news as text:
                     39:  *
                     40:  *   #N:uicsovax:10100072:000:251
                     41:  *   uicsovax!essick      Apr  5 15:51:00 1982
                     42:  *   
                     43:  *   This is a silly little note that I shall dump to the
                     44:  *   news program. I hope that things work all correctly because I do not
                     45:  *   wish to bother much more with them.
                     46:  *   I still have to worry about bringing this stuff back into notesfiles!
                     47:  *   This is the last line.
                     48:  *   
                     49:  *
                     50:  *     The format of an ALMOST generic response, sent as text to news:
                     51:  *
                     52:  *   #R:uicsovax:10100068:uicsovax:10100070:004:331
                     53:  *   uicsovax!essick      Apr  5 15:47:00 1982
                     54:  *   
                     55:  *   This is a test note to see how well things are going with the news dumping
                     56:  *   back into the notesfile stuff.
                     57:  *   
                     58:  *   The previous line should have been blank. THis will be the last line
                     59:  *   ----------
                     60:  *   This is another response to the note. The first got lost somewhere.
                     61:  *   THis is the last line.
                     62:  *   
                     63:  *     The #R fields, in order, are:
                     64:  *     base note system and id, response system and id, resp status and
                     65:  *     number of bytes in the text.
                     66:  *     The note is similiar but has only the basenote system and id.
                     67:  *
                     68:  *     second is author and date, almost in ctime(3) format.
                     69:  *     third is always blank, no characters on it.
                     70:  *     there is always a newline at the end of the text, even if it 
                     71:  *     was not in the stored note/response. This keeps others happy
                     72:  *
                     73:  */

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.