Fossil SCM

Expanded the control artifact/card summary table to distinguish between optional and required cards.

stephan 2013-08-11 13:53 trunk

Commit e946977e0ea596c2a7950df1072e74c8ca81b7c8

Parent 30f44eb2e466ffb…

1 file changed +50 -47

M www/fileformat.wiki

+50 -47

		--- www/fileformat.wiki
		+++ www/fileformat.wiki
		@@ -499,11 +499,11 @@
499	499	The optional N card specifies the mimetype of the text of the event
500	500	that is contained in the W card. If the N card is omitted, then the
501	501	W card text mimetype is assumed to be text/x-fossil, which is the
502	502	Fossil wiki format.
503	503
504		-The option P card specifies a prior event with the same event-id from
	504	+The optional P card specifies a prior event with the same event-id from
505	505	which the current event is an edit. The P card is a hint to the system
506	506	that it might be space efficient to store one event as a delta of the
507	507	other.
508	508
509	509	An event might contain one or more T-cards used to set
		@@ -531,12 +531,14 @@
531	531
532	532
533	533	<a name="summary"></a>
534	534	<h2>8.0 Card Summary</h2>
535	535
536		-The following table summaries the various kinds of cards that
537		-appear on Fossil artifacts:
	536	+The following table summaries the various kinds of cards that appear
	537	+on Fossil artifacts. An "R" means that the card is required and "O"
	538	+means it is optional (or optional in specific contexts). A blank entry
	539	+means the card is not legal for that artifact type.
538	540
539	541	<table border=1 width="100%">
540	542	<tr>
541	543	<th rowspan=2 valign=bottom>Card Format</th>
542	544	<th colspan=7>Used By</th>
		@@ -555,56 +557,56 @@
555	557	<td> </td>
556	558	<td> </td>
557	559	<td> </td>
558	560	<td> </td>
559	561	<td> </td>
560		-<td align=center><b>X</b></td>
	562	+<td align=center><b>R</b></td>
561	563	<td> </td>
562	564	</tr>
563	565	<tr>
564	566	<td><b>B</b> <i>baseline</i></td>
565		-<td align=center><b>X</b></td>
	567	+<td align=center><b>O</b></td>
566	568	<td> </td>
567	569	<td> </td>
568	570	<td> </td>
569	571	<td> </td>
570	572	<td> </td>
571	573	<td> </td>
572	574	</tr>
573	575	<tr>
574	576	<td><b>C</b> <i>comment-text</i></td>
575		-<td align=center><b>X</b></td>
	577	+<td align=center><b>R</b></td>
576	578	<td> </td>
577	579	<td> </td>
578	580	<td> </td>
579	581	<td> </td>
580		-<td align=center><b>X</b></td>
581		-<td align=center><b>X</b></td>
	582	+<td align=center><b>O</b></td>
	583	+<td align=center><b>R</b></td>
582	584	</tr>
583	585	<tr>
584	586	<td><b>D</b> <i>date-time-stamp</i></td>
585		-<td align=center><b>X</b></td>
	587	+<td align=center><b>R</b></td>
586	588	<td align=center> </td>
587		-<td align=center><b>X</b></td>
588		-<td align=center><b>X</b></td>
589		-<td align=center><b>X</b></td>
590		-<td align=center><b>X</b></td>
591		-<td align=center><b>X</b></td>
	589	+<td align=center><b>R</b></td>
	590	+<td align=center><b>R</b></td>
	591	+<td align=center><b>R</b></td>
	592	+<td align=center><b>R</b></td>
	593	+<td align=center><b>R</b></td>
592	594	</tr>
593	595	<tr>
594	596	<td><b>E</b> <i>event-time event-id</i></td>
595	597	<td align=center> </td>
596	598	<td align=center> </td>
597	599	<td align=center> </td>
598	600	<td align=center> </td>
599	601	<td align=center> </td>
600	602	<td align=center> </td>
601		-<td align=center><b>X</b></td>
	603	+<td align=center><b>R</b></td>
602	604	</tr>
603	605	<tr>
604	606	<td><b>F</b> <i>filename uuid permissions oldname</i></td>
605		-<td align=center><b>X</b></td>
	607	+<td align=center><b>O</b></td>
606	608	<td align=center> </td>
607	609	<td align=center> </td>
608	610	<td align=center> </td>
609	611	<td align=center> </td>
610	612	<td align=center> </td>
		@@ -614,119 +616,120 @@
614	616	<td><b>J</b> <i>name value</i></td>
615	617	<td align=center> </td>
616	618	<td align=center> </td>
617	619	<td align=center> </td>
618	620	<td align=center> </td>
619		-<td align=center><b>X</b></td>
	621	+<td align=center><b>R?</b></td>
620	622	<td align=center> </td>
621	623	<td align=center> </td>
622	624	</tr>
623	625	<tr>
624	626	<td><b>K</b> <i>ticket-uuid</i></td>
625	627	<td align=center> </td>
626	628	<td align=center> </td>
627	629	<td align=center> </td>
628	630	<td align=center> </td>
629		-<td align=center><b>X</b></td>
	631	+<td align=center><b>R</b></td>
630	632	<td align=center> </td>
631	633	<td align=center> </td>
632	634	</tr>
633	635	<tr>
634	636	<td><b>L</b> <i>wiki-title</i></td>
635	637	<td align=center> </td>
636	638	<td align=center> </td>
637	639	<td align=center> </td>
638		-<td align=center><b>X</b></td>
	640	+<td align=center><b>R</b></td>
639	641	<td align=center> </td>
640	642	<td align=center> </td>
641	643	<td align=center> </td>
642	644	</tr>
643	645	<tr>
644	646	<td><b>M</b> <i>uuid</i></td>
645	647	<td align=center> </td>
646		-<td align=center><b>X</b></td>
	648	+<td align=center><b>R</b></td>
647	649	<td align=center> </td>
648	650	<td align=center> </td>
649	651	<td align=center> </td>
650	652	<td align=center> </td>
651	653	<td align=center> </td>
652	654	</tr>
653	655	<tr>
654	656	<td><b>N</b> <i>mimetype</i></td>
655		-<td align=center><b>X</b></td>
	657	+<td align=center><b>O</b></td>
656	658	<td align=center> </td>
657	659	<td align=center> </td>
658		-<td align=center><b>X</b></td>
	660	+<td align=center><b>O</b></td>
659	661	<td align=center> </td>
660		-<td align=center><b>X</b></td>
661		-<td align=center><b>X</b></td>
	662	+<td align=center><b>O</b></td>
	663	+<td align=center><b>O</b></td>
662	664	</tr>
663	665	<tr>
664	666	<td><b>P</b> <i>uuid ...</i></td>
665		-<td align=center><b>X</b></td>
	667	+<td align=center><b>O</b></td>
666	668	<td align=center> </td>
667	669	<td align=center> </td>
668		-<td align=center><b>X</b></td>
	670	+<td align=center><b>O</b></td>
669	671	<td align=center> </td>
670	672	<td align=center> </td>
671		-<td align=center> </td>
	673	+<td align=center><b>O</b></td>
672	674	</tr>
673	675	<tr>
674	676	<td><b>Q</b> (<b>+</b>\|<b>-</b>)<i>uuid uuid</i></td>
675		-<td align=center><b>X</b></td>
	677	+<td align=center><b>O</b></td>
676	678	<td align=center> </td>
677	679	<td align=center> </td>
678	680	<td align=center> </td>
679	681	<td align=center> </td>
680	682	<td align=center> </td>
681	683	<td align=center> </td>
682	684	</tr>
683	685	<tr>
684	686	<td><b>R</b> <i>md5sum</i></td>
685		-<td align=center><b>X</b></td>
	687	+<td align=center><b>O*</b></td>
686	688	<td align=center> </td>
687	689	<td align=center> </td>
688	690	<td align=center> </td>
689	691	<td align=center> </td>
690	692	<td align=center> </td>
691	693	<td align=center> </td>
	694	+<tr><td> </td><td colspan='7'>* = Required when using F cards</td></tr>
692	695	<tr>
693	696	<td><b>T</b> (<b>+</b>\|<b>*</b>\|<b>-</b>)<i>tagname uuid value</i></td>
694		-<td align=center><b>X</b></td>
	697	+<td align=center><b>O</b></td>
695	698	<td align=center> </td>
696		-<td align=center><b>X</b></td>
	699	+<td align=center><b>R</b></td>
697	700	<td align=center> </td>
698	701	<td align=center> </td>
699	702	<td align=center> </td>
700		-<td align=center><b>X</b></td>
	703	+<td align=center><b>O</b></td>
701	704	</tr>
702	705	<tr>
703	706	<td><b>U</b> <i>username</i></td>
704		-<td align=center><b>X</b></td>
	707	+<td align=center><b>R?</b></td>
705	708	<td align=center> </td>
706		-<td align=center><b>X</b></td>
707		-<td align=center><b>X</b></td>
708		-<td align=center><b>X</b></td>
709		-<td align=center><b>X</b></td>
710		-<td align=center><b>X</b></td>
	709	+<td align=center><b>R</b></td>
	710	+<td align=center><b>R</b></td>
	711	+<td align=center><b>R</b></td>
	712	+<td align=center><b>O</b></td>
	713	+<td align=center><b>O</b></td>
711	714	</tr>
712	715	<tr>
713	716	<td><b>W</b> <i>size</i></td>
714	717	<td align=center> </td>
715	718	<td align=center> </td>
716	719	<td align=center> </td>
717		-<td align=center><b>X</b></td>
	720	+<td align=center><b>R</b></td>
718	721	<td align=center> </td>
719	722	<td align=center> </td>
720		-<td align=center><b>X</b></td>
	723	+<td align=center><b>R</b></td>
721	724	</tr>
722	725	<tr>
723	726	<td><b>Z</b> <i>md5sum</i></td>
724		-<td align=center><b>X</b></td>
725		-<td align=center><b>X</b></td>
726		-<td align=center><b>X</b></td>
727		-<td align=center><b>X</b></td>
728		-<td align=center><b>X</b></td>
729		-<td align=center><b>X</b></td>
730		-<td align=center><b>X</b></td>
	727	+<td align=center><b>R</b></td>
	728	+<td align=center><b>R</b></td>
	729	+<td align=center><b>R</b></td>
	730	+<td align=center><b>R</b></td>
	731	+<td align=center><b>R</b></td>
	732	+<td align=center><b>R</b></td>
	733	+<td align=center><b>R</b></td>
731	734	</tr>
732	735	</table>
733	736

	--- www/fileformat.wiki
	+++ www/fileformat.wiki
	@@ -499,11 +499,11 @@
499	The optional N card specifies the mimetype of the text of the event
500	that is contained in the W card. If the N card is omitted, then the
501	W card text mimetype is assumed to be text/x-fossil, which is the
502	Fossil wiki format.
503
504	The option P card specifies a prior event with the same event-id from
505	which the current event is an edit. The P card is a hint to the system
506	that it might be space efficient to store one event as a delta of the
507	other.
508
509	An event might contain one or more T-cards used to set
	@@ -531,12 +531,14 @@
531
532
533	<a name="summary"></a>
534	<h2>8.0 Card Summary</h2>
535
536	The following table summaries the various kinds of cards that
537	appear on Fossil artifacts:


538
539	<table border=1 width="100%">
540	<tr>
541	<th rowspan=2 valign=bottom>Card Format</th>
542	<th colspan=7>Used By</th>
	@@ -555,56 +557,56 @@
555	<td> </td>
556	<td> </td>
557	<td> </td>
558	<td> </td>
559	<td> </td>
560	<td align=center><b>X</b></td>
561	<td> </td>
562	</tr>
563	<tr>
564	<td><b>B</b> <i>baseline</i></td>
565	<td align=center><b>X</b></td>
566	<td> </td>
567	<td> </td>
568	<td> </td>
569	<td> </td>
570	<td> </td>
571	<td> </td>
572	</tr>
573	<tr>
574	<td><b>C</b> <i>comment-text</i></td>
575	<td align=center><b>X</b></td>
576	<td> </td>
577	<td> </td>
578	<td> </td>
579	<td> </td>
580	<td align=center><b>X</b></td>
581	<td align=center><b>X</b></td>
582	</tr>
583	<tr>
584	<td><b>D</b> <i>date-time-stamp</i></td>
585	<td align=center><b>X</b></td>
586	<td align=center> </td>
587	<td align=center><b>X</b></td>
588	<td align=center><b>X</b></td>
589	<td align=center><b>X</b></td>
590	<td align=center><b>X</b></td>
591	<td align=center><b>X</b></td>
592	</tr>
593	<tr>
594	<td><b>E</b> <i>event-time event-id</i></td>
595	<td align=center> </td>
596	<td align=center> </td>
597	<td align=center> </td>
598	<td align=center> </td>
599	<td align=center> </td>
600	<td align=center> </td>
601	<td align=center><b>X</b></td>
602	</tr>
603	<tr>
604	<td><b>F</b> <i>filename uuid permissions oldname</i></td>
605	<td align=center><b>X</b></td>
606	<td align=center> </td>
607	<td align=center> </td>
608	<td align=center> </td>
609	<td align=center> </td>
610	<td align=center> </td>
	@@ -614,119 +616,120 @@
614	<td><b>J</b> <i>name value</i></td>
615	<td align=center> </td>
616	<td align=center> </td>
617	<td align=center> </td>
618	<td align=center> </td>
619	<td align=center><b>X</b></td>
620	<td align=center> </td>
621	<td align=center> </td>
622	</tr>
623	<tr>
624	<td><b>K</b> <i>ticket-uuid</i></td>
625	<td align=center> </td>
626	<td align=center> </td>
627	<td align=center> </td>
628	<td align=center> </td>
629	<td align=center><b>X</b></td>
630	<td align=center> </td>
631	<td align=center> </td>
632	</tr>
633	<tr>
634	<td><b>L</b> <i>wiki-title</i></td>
635	<td align=center> </td>
636	<td align=center> </td>
637	<td align=center> </td>
638	<td align=center><b>X</b></td>
639	<td align=center> </td>
640	<td align=center> </td>
641	<td align=center> </td>
642	</tr>
643	<tr>
644	<td><b>M</b> <i>uuid</i></td>
645	<td align=center> </td>
646	<td align=center><b>X</b></td>
647	<td align=center> </td>
648	<td align=center> </td>
649	<td align=center> </td>
650	<td align=center> </td>
651	<td align=center> </td>
652	</tr>
653	<tr>
654	<td><b>N</b> <i>mimetype</i></td>
655	<td align=center><b>X</b></td>
656	<td align=center> </td>
657	<td align=center> </td>
658	<td align=center><b>X</b></td>
659	<td align=center> </td>
660	<td align=center><b>X</b></td>
661	<td align=center><b>X</b></td>
662	</tr>
663	<tr>
664	<td><b>P</b> <i>uuid ...</i></td>
665	<td align=center><b>X</b></td>
666	<td align=center> </td>
667	<td align=center> </td>
668	<td align=center><b>X</b></td>
669	<td align=center> </td>
670	<td align=center> </td>
671	<td align=center> </td>
672	</tr>
673	<tr>
674	<td><b>Q</b> (<b>+</b>\|<b>-</b>)<i>uuid uuid</i></td>
675	<td align=center><b>X</b></td>
676	<td align=center> </td>
677	<td align=center> </td>
678	<td align=center> </td>
679	<td align=center> </td>
680	<td align=center> </td>
681	<td align=center> </td>
682	</tr>
683	<tr>
684	<td><b>R</b> <i>md5sum</i></td>
685	<td align=center><b>X</b></td>
686	<td align=center> </td>
687	<td align=center> </td>
688	<td align=center> </td>
689	<td align=center> </td>
690	<td align=center> </td>
691	<td align=center> </td>

692	<tr>
693	<td><b>T</b> (<b>+</b>\|<b>*</b>\|<b>-</b>)<i>tagname uuid value</i></td>
694	<td align=center><b>X</b></td>
695	<td align=center> </td>
696	<td align=center><b>X</b></td>
697	<td align=center> </td>
698	<td align=center> </td>
699	<td align=center> </td>
700	<td align=center><b>X</b></td>
701	</tr>
702	<tr>
703	<td><b>U</b> <i>username</i></td>
704	<td align=center><b>X</b></td>
705	<td align=center> </td>
706	<td align=center><b>X</b></td>
707	<td align=center><b>X</b></td>
708	<td align=center><b>X</b></td>
709	<td align=center><b>X</b></td>
710	<td align=center><b>X</b></td>
711	</tr>
712	<tr>
713	<td><b>W</b> <i>size</i></td>
714	<td align=center> </td>
715	<td align=center> </td>
716	<td align=center> </td>
717	<td align=center><b>X</b></td>
718	<td align=center> </td>
719	<td align=center> </td>
720	<td align=center><b>X</b></td>
721	</tr>
722	<tr>
723	<td><b>Z</b> <i>md5sum</i></td>
724	<td align=center><b>X</b></td>
725	<td align=center><b>X</b></td>
726	<td align=center><b>X</b></td>
727	<td align=center><b>X</b></td>
728	<td align=center><b>X</b></td>
729	<td align=center><b>X</b></td>
730	<td align=center><b>X</b></td>
731	</tr>
732	</table>
733

	--- www/fileformat.wiki
	+++ www/fileformat.wiki
	@@ -499,11 +499,11 @@
499	The optional N card specifies the mimetype of the text of the event
500	that is contained in the W card. If the N card is omitted, then the
501	W card text mimetype is assumed to be text/x-fossil, which is the
502	Fossil wiki format.
503
504	The optional P card specifies a prior event with the same event-id from
505	which the current event is an edit. The P card is a hint to the system
506	that it might be space efficient to store one event as a delta of the
507	other.
508
509	An event might contain one or more T-cards used to set
	@@ -531,12 +531,14 @@
531
532
533	<a name="summary"></a>
534	<h2>8.0 Card Summary</h2>
535
536	The following table summaries the various kinds of cards that appear
537	on Fossil artifacts. An "R" means that the card is required and "O"
538	means it is optional (or optional in specific contexts). A blank entry
539	means the card is not legal for that artifact type.
540
541	<table border=1 width="100%">
542	<tr>
543	<th rowspan=2 valign=bottom>Card Format</th>
544	<th colspan=7>Used By</th>
	@@ -555,56 +557,56 @@
557	<td> </td>
558	<td> </td>
559	<td> </td>
560	<td> </td>
561	<td> </td>
562	<td align=center><b>R</b></td>
563	<td> </td>
564	</tr>
565	<tr>
566	<td><b>B</b> <i>baseline</i></td>
567	<td align=center><b>O</b></td>
568	<td> </td>
569	<td> </td>
570	<td> </td>
571	<td> </td>
572	<td> </td>
573	<td> </td>
574	</tr>
575	<tr>
576	<td><b>C</b> <i>comment-text</i></td>
577	<td align=center><b>R</b></td>
578	<td> </td>
579	<td> </td>
580	<td> </td>
581	<td> </td>
582	<td align=center><b>O</b></td>
583	<td align=center><b>R</b></td>
584	</tr>
585	<tr>
586	<td><b>D</b> <i>date-time-stamp</i></td>
587	<td align=center><b>R</b></td>
588	<td align=center> </td>
589	<td align=center><b>R</b></td>
590	<td align=center><b>R</b></td>
591	<td align=center><b>R</b></td>
592	<td align=center><b>R</b></td>
593	<td align=center><b>R</b></td>
594	</tr>
595	<tr>
596	<td><b>E</b> <i>event-time event-id</i></td>
597	<td align=center> </td>
598	<td align=center> </td>
599	<td align=center> </td>
600	<td align=center> </td>
601	<td align=center> </td>
602	<td align=center> </td>
603	<td align=center><b>R</b></td>
604	</tr>
605	<tr>
606	<td><b>F</b> <i>filename uuid permissions oldname</i></td>
607	<td align=center><b>O</b></td>
608	<td align=center> </td>
609	<td align=center> </td>
610	<td align=center> </td>
611	<td align=center> </td>
612	<td align=center> </td>
	@@ -614,119 +616,120 @@
616	<td><b>J</b> <i>name value</i></td>
617	<td align=center> </td>
618	<td align=center> </td>
619	<td align=center> </td>
620	<td align=center> </td>
621	<td align=center><b>R?</b></td>
622	<td align=center> </td>
623	<td align=center> </td>
624	</tr>
625	<tr>
626	<td><b>K</b> <i>ticket-uuid</i></td>
627	<td align=center> </td>
628	<td align=center> </td>
629	<td align=center> </td>
630	<td align=center> </td>
631	<td align=center><b>R</b></td>
632	<td align=center> </td>
633	<td align=center> </td>
634	</tr>
635	<tr>
636	<td><b>L</b> <i>wiki-title</i></td>
637	<td align=center> </td>
638	<td align=center> </td>
639	<td align=center> </td>
640	<td align=center><b>R</b></td>
641	<td align=center> </td>
642	<td align=center> </td>
643	<td align=center> </td>
644	</tr>
645	<tr>
646	<td><b>M</b> <i>uuid</i></td>
647	<td align=center> </td>
648	<td align=center><b>R</b></td>
649	<td align=center> </td>
650	<td align=center> </td>
651	<td align=center> </td>
652	<td align=center> </td>
653	<td align=center> </td>
654	</tr>
655	<tr>
656	<td><b>N</b> <i>mimetype</i></td>
657	<td align=center><b>O</b></td>
658	<td align=center> </td>
659	<td align=center> </td>
660	<td align=center><b>O</b></td>
661	<td align=center> </td>
662	<td align=center><b>O</b></td>
663	<td align=center><b>O</b></td>
664	</tr>
665	<tr>
666	<td><b>P</b> <i>uuid ...</i></td>
667	<td align=center><b>O</b></td>
668	<td align=center> </td>
669	<td align=center> </td>
670	<td align=center><b>O</b></td>
671	<td align=center> </td>
672	<td align=center> </td>
673	<td align=center><b>O</b></td>
674	</tr>
675	<tr>
676	<td><b>Q</b> (<b>+</b>\|<b>-</b>)<i>uuid uuid</i></td>
677	<td align=center><b>O</b></td>
678	<td align=center> </td>
679	<td align=center> </td>
680	<td align=center> </td>
681	<td align=center> </td>
682	<td align=center> </td>
683	<td align=center> </td>
684	</tr>
685	<tr>
686	<td><b>R</b> <i>md5sum</i></td>
687	<td align=center><b>O*</b></td>
688	<td align=center> </td>
689	<td align=center> </td>
690	<td align=center> </td>
691	<td align=center> </td>
692	<td align=center> </td>
693	<td align=center> </td>
694	<tr><td> </td><td colspan='7'>* = Required when using F cards</td></tr>
695	<tr>
696	<td><b>T</b> (<b>+</b>\|<b>*</b>\|<b>-</b>)<i>tagname uuid value</i></td>
697	<td align=center><b>O</b></td>
698	<td align=center> </td>
699	<td align=center><b>R</b></td>
700	<td align=center> </td>
701	<td align=center> </td>
702	<td align=center> </td>
703	<td align=center><b>O</b></td>
704	</tr>
705	<tr>
706	<td><b>U</b> <i>username</i></td>
707	<td align=center><b>R?</b></td>
708	<td align=center> </td>
709	<td align=center><b>R</b></td>
710	<td align=center><b>R</b></td>
711	<td align=center><b>R</b></td>
712	<td align=center><b>O</b></td>
713	<td align=center><b>O</b></td>
714	</tr>
715	<tr>
716	<td><b>W</b> <i>size</i></td>
717	<td align=center> </td>
718	<td align=center> </td>
719	<td align=center> </td>
720	<td align=center><b>R</b></td>
721	<td align=center> </td>
722	<td align=center> </td>
723	<td align=center><b>R</b></td>
724	</tr>
725	<tr>
726	<td><b>Z</b> <i>md5sum</i></td>
727	<td align=center><b>R</b></td>
728	<td align=center><b>R</b></td>
729	<td align=center><b>R</b></td>
730	<td align=center><b>R</b></td>
731	<td align=center><b>R</b></td>
732	<td align=center><b>R</b></td>
733	<td align=center><b>R</b></td>
734	</tr>
735	</table>
736

Fossil SCM

Keyboard Shortcuts