Patchwork [wwwdocs] Re: [PATCH] invoke.texi: "compile time", "run time" cleanup

login
register
mail settings
Submitter Sandra Loosemore
Date Jan. 30, 2012, 1:13 a.m.
Message ID <4F25EED0.2010605@codesourcery.com>
Download mbox | patch
Permalink /patch/138488/
State New
Headers show

Comments

Sandra Loosemore - Jan. 30, 2012, 1:13 a.m.
On 01/29/2012 07:31 AM, Joseph S. Myers wrote:
> On Sat, 28 Jan 2012, Sandra Loosemore wrote:
>
>> 2012-01-28  Sandra Loosemore<sandra@codesourcery.com>
>>
>> 	gcc/
>> 	* doc/invoke.texi: Make usage of "compile time" and
>> 	"run time"/"runtime" consistent throughout the file.
>
> OK.  Could you post a patch to codingconventions.html to document the
> conventions you described in your message?

Like this?  The table formatting encourages brevity, but I can twiddle 
it somehow if more detail is necessary.

-Sandra
Joseph S. Myers - Jan. 30, 2012, 3:23 p.m.
On Sun, 29 Jan 2012, Sandra Loosemore wrote:

> On 01/29/2012 07:31 AM, Joseph S. Myers wrote:
> > On Sat, 28 Jan 2012, Sandra Loosemore wrote:
> > 
> > > 2012-01-28  Sandra Loosemore<sandra@codesourcery.com>
> > > 
> > > 	gcc/
> > > 	* doc/invoke.texi: Make usage of "compile time" and
> > > 	"run time"/"runtime" consistent throughout the file.
> > 
> > OK.  Could you post a patch to codingconventions.html to document the
> > conventions you described in your message?
> 
> Like this?  The table formatting encourages brevity, but I can twiddle it
> somehow if more detail is necessary.

OK, unless Gerald sees any problems with it.

Patch

? htdocs/codingconventions.html.~1.63.~
Index: htdocs/codingconventions.html
===================================================================
RCS file: /cvs/gcc/wwwdocs/htdocs/codingconventions.html,v
retrieving revision 1.63
diff -u -r1.63 codingconventions.html
--- htdocs/codingconventions.html	12 Feb 2011 15:49:51 -0000	1.63
+++ htdocs/codingconventions.html	30 Jan 2012 01:05:29 -0000
@@ -280,6 +280,18 @@ 
     <td></td>
   </tr>
   <tr>
+    <td>"compilation time" (noun);
+      how long it takes to compile the program</td>
+    <td>"compile time"</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>"compile time" (noun), "compile-time" (adjective);
+      the time at which the program is compiled</td>
+    <td></td>
+    <td></td>
+  </tr>
+  <tr>
     <td>"dependent" (adjective), "dependence", "dependency"</td>
     <td>"dependant", "dependance", "dependancy"</td>
     <td></td>
@@ -295,6 +307,12 @@ 
     <td>Established convention</td>
   </tr>
   <tr>
+    <td>"execution time" (noun);
+      how long it takes the program to run</td>
+    <td>"run time" or "runtime"</td>
+    <td></td>
+  </tr>
+  <tr>
     <td>"free software" or just "free"</td>
     <td>"Open Source" or "OpenSource"</td>
   </tr>
@@ -314,6 +332,12 @@ 
     <td></td>
   </tr>
   <tr>
+    <td>"link time" (noun), "link-time" (adjective);
+      the time at which the program is linked</td>
+    <td></td>
+    <td></td>
+  </tr>
+  <tr>
     <td>"lowercase"</td>
     <td>"lower case" or "lower-case"</td>
     <td></td>
@@ -357,6 +381,18 @@ 
     <td></td>
   </tr>
   <tr>
+    <td>"run time" (noun), "run-time" (adjective);
+      the time at which the program is run</td>
+    <td>"runtime"</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>"runtime" (both noun and adjective);
+      libraries and system support present at run time</td>
+    <td>"run time", "run-time"</td>
+    <td></td>
+  </tr>
+  <tr>
     <td>"SPARC"</td>
     <td>"Sparc" or "sparc"</td>
   </tr>