RFC: Tool Introspection Wording

Initial, ported from wg21 source, wording for ecostd/rfcs#2

Author: grafikrobot

build.jam

@@ -21,3 +21,13 @@ install std-pub
 		<location>.build/pub
 		<doc-stage>draft:<name>draft.html
 	;
+
+install std-json
+	:	[ glob src/std_*.json ]
+	:	<location>.build/pub
+	;
+
+alias all
+	:	std-pub std-json
+		test//validate
+	;

src/std-docinfo.html

@@ -22,4 +22,98 @@
 #covertitle .title {
 	font-size: 1.2em;
 }
+
+/* Table of Contents. */
+
+#toc ul.sectlevel1 > li {
+	margin-bottom: 1em;
+}
+#toc ul.sectlevel1 > li > a {
+	font-weight: bold;
+}
+
+/* Admonitions, i.e. notes. */
+
+.admonitionblock > table {
+	width: auto;
+}
+.admonitionblock .icon {
+	vertical-align: top;
+	padding: 0 0.25em 0 0 !important;
+	width: fit-content !important;
+}
+.admonitionblock .icon .title {
+	text-transform: none !important;
+	width: fit-content !important;
+	font-weight: normal !important;
+	font-style: italic !important;
+	font-family: serif !important;
+	font-size: inherit !important;
+}
+.admonitionblock .content {
+	border: none !important;
+	padding: 0 !important;
+}
+
+/* General formatting. */
+
+.indented {
+	margin-left: 3em;
+}
+
+.term {
+	font-style: italic;
+	font-family: sans-serif;
+}
+
+.ucode::before {
+	content: "U+";
+}
+.ucode, .uname {
+	font-family: serif;
+	font-style: normal;
+	text-transform: uppercase;
+}
+
+/* BNF grammar descriptions. */
+
+.bnf {
+	margin-left: 3em;
+}
+.bnf dl dt {
+	font-weight: normal;
+	font-style: italic;
+	font-family: sans-serif;
+}
+.bnf dl dd {
+	margin-left: 3em;
+	font-weight: normal;
+	font-style: italic;
+	font-family: sans-serif;
+}
+.bnf .opt::after {
+	content: "opt";
+	position: relative;
+	top: 0.25em;
+	font-size: 60%;
+}
+.bnf .descr {
+	font-style: normal;
+	font-family: serif;
+}
+
+/* Examples. */
+
+.exampleblock > .content::before {
+	content: "Example: ";
+	font-weight: normal !important;
+	font-style: italic !important;
+	font-family: serif !important;
+}
+.exampleblock > .content {
+	background: none;
+	border: none;
+	padding: 0;
+	box-shadow: none;
+}
 </style>

src/std.adoc

@@ -41,14 +41,18 @@ toc::[]
 include::std.license.adoc[leveloffset=+1]
 
 //-------------------------------------------------------------------
-// Chapters..
+// Intro Chapters..
 :sectnums:
 
 include::std.intro.adoc[leveloffset=+1]
 include::std.conventions.adoc[leveloffset=+1]
 include::std.refs.adoc[leveloffset=+1]
 include::std.defs.adoc[leveloffset=+1]
 
+//-------------------------------------------------------------------
+// Body Chapters..
+include::std.introspection.adoc[leveloffset=+1]
+
 //-------------------------------------------------------------------
 // Appendices..
 :sectnums!:

src/std.defs.adoc

@@ -9,10 +9,31 @@ and the following apply.
 Terms that are used only in a small portion of this document are defined where
 they are used and _italicized_ where they are defined.
 
+*application*: A computer program that performs some desired function.
+
+*capability*: An aspect of an overall specification that defines a subset of the
+entire specification.
+
+*directory*: A file that contains directory entries.
+
+*file*: An object that can be written to, or read from, or both.
+
+*filename*: A sequence of bytes used to name a file.
+
+*parent directory*: A directory containing a directory entry for the file under
+discussion.
+
+*pathname*: A string that is used to identify a file.
+
+*implementation define*: ???
+
+
 ////
+
 (((application)))
 
 [[defns.application,([defns.application])]]
 application::
 a computer program that performs some desired function.
+
 ////