Fossil SCM
Add the "History" section to the makeheaders documentation.
Commit
280981368fe7c7234e657d93ce34ad7f012de251
Parent
4dcfbc1c8a82ed8…
1 file changed
+29
-2
+29
-2
| --- src/makeheaders.html | ||
| +++ src/makeheaders.html | ||
| @@ -42,11 +42,13 @@ | ||
| 42 | 42 | </ul> |
| 43 | 43 | <li><a href="#H0015">4.0 Using Makeheaders To Generate Documentation</a> |
| 44 | 44 | |
| 45 | 45 | <li><a href="#H0016">5.0 Compiling The Makeheaders Program</a> |
| 46 | 46 | |
| 47 | -<li><a href="#H0017">6.0 Summary And Conclusion</a> | |
| 47 | +<li><a href="#H0017">6.0 History</a> | |
| 48 | + | |
| 49 | +<li><a href="#H0018">6.0 Summary And Conclusion</a> | |
| 48 | 50 | </ul><a name="H0002"></a> |
| 49 | 51 | <h2>1.0 Background</h2> |
| 50 | 52 | |
| 51 | 53 | <p> |
| 52 | 54 | A piece of C source code can be one of two things: |
| @@ -1094,11 +1096,36 @@ | ||
| 1094 | 1096 | It is known to compile using several variations of GCC for Unix |
| 1095 | 1097 | as well as Cygwin32 and MSVC 5.0 for Win32. |
| 1096 | 1098 | </p> |
| 1097 | 1099 | |
| 1098 | 1100 | <a name="H0017"></a> |
| 1099 | -<h2>6.0 Summary And Conclusion</h2> | |
| 1101 | +<h2>6.0 History</h2> | |
| 1102 | + | |
| 1103 | +<p> | |
| 1104 | +The makeheaders program was first written by D. Richard Hipp | |
| 1105 | +(also the original author of | |
| 1106 | +<a href="https://sqlite.org/">SQLite</a> and | |
| 1107 | +<a href="https://www.fossil-scm.org/">Fossil</a>) in 1993. | |
| 1108 | +Hipp open-sourced the project immediately, but it never caught | |
| 1109 | +on with any other developers and it continued to be used mostly | |
| 1110 | +by Hipp himself for over a decade. When Hipp was first writing | |
| 1111 | +the Fossil version control system in 2006 and 2007, he used | |
| 1112 | +makeheaders on that project to help simplify the source code. | |
| 1113 | +As the popularity of Fossil increased, the makeheaders | |
| 1114 | +that was incorporated into the Fossil source tree became the | |
| 1115 | +"official" makeheaders implementation. | |
| 1116 | +</p> | |
| 1117 | + | |
| 1118 | +<p> | |
| 1119 | +As this paragraph is being composed (2016-11-05), Fossil is the | |
| 1120 | +only project known to Hipp that is still using makeheaders. On | |
| 1121 | +the other hand, makeheaders has served the Fossil project well and | |
| 1122 | +there are no plans remove it. | |
| 1123 | +</p> | |
| 1124 | + | |
| 1125 | +<a name="H0018"></a> | |
| 1126 | +<h2>7.0 Summary And Conclusion</h2> | |
| 1100 | 1127 | |
| 1101 | 1128 | <p> |
| 1102 | 1129 | The makeheaders program will automatically generate a minimal header file |
| 1103 | 1130 | for each of a set of C source and header files, and will |
| 1104 | 1131 | generate a composite header file for the entire source file suite, |
| 1105 | 1132 |
| --- src/makeheaders.html | |
| +++ src/makeheaders.html | |
| @@ -42,11 +42,13 @@ | |
| 42 | </ul> |
| 43 | <li><a href="#H0015">4.0 Using Makeheaders To Generate Documentation</a> |
| 44 | |
| 45 | <li><a href="#H0016">5.0 Compiling The Makeheaders Program</a> |
| 46 | |
| 47 | <li><a href="#H0017">6.0 Summary And Conclusion</a> |
| 48 | </ul><a name="H0002"></a> |
| 49 | <h2>1.0 Background</h2> |
| 50 | |
| 51 | <p> |
| 52 | A piece of C source code can be one of two things: |
| @@ -1094,11 +1096,36 @@ | |
| 1094 | It is known to compile using several variations of GCC for Unix |
| 1095 | as well as Cygwin32 and MSVC 5.0 for Win32. |
| 1096 | </p> |
| 1097 | |
| 1098 | <a name="H0017"></a> |
| 1099 | <h2>6.0 Summary And Conclusion</h2> |
| 1100 | |
| 1101 | <p> |
| 1102 | The makeheaders program will automatically generate a minimal header file |
| 1103 | for each of a set of C source and header files, and will |
| 1104 | generate a composite header file for the entire source file suite, |
| 1105 |
| --- src/makeheaders.html | |
| +++ src/makeheaders.html | |
| @@ -42,11 +42,13 @@ | |
| 42 | </ul> |
| 43 | <li><a href="#H0015">4.0 Using Makeheaders To Generate Documentation</a> |
| 44 | |
| 45 | <li><a href="#H0016">5.0 Compiling The Makeheaders Program</a> |
| 46 | |
| 47 | <li><a href="#H0017">6.0 History</a> |
| 48 | |
| 49 | <li><a href="#H0018">6.0 Summary And Conclusion</a> |
| 50 | </ul><a name="H0002"></a> |
| 51 | <h2>1.0 Background</h2> |
| 52 | |
| 53 | <p> |
| 54 | A piece of C source code can be one of two things: |
| @@ -1094,11 +1096,36 @@ | |
| 1096 | It is known to compile using several variations of GCC for Unix |
| 1097 | as well as Cygwin32 and MSVC 5.0 for Win32. |
| 1098 | </p> |
| 1099 | |
| 1100 | <a name="H0017"></a> |
| 1101 | <h2>6.0 History</h2> |
| 1102 | |
| 1103 | <p> |
| 1104 | The makeheaders program was first written by D. Richard Hipp |
| 1105 | (also the original author of |
| 1106 | <a href="https://sqlite.org/">SQLite</a> and |
| 1107 | <a href="https://www.fossil-scm.org/">Fossil</a>) in 1993. |
| 1108 | Hipp open-sourced the project immediately, but it never caught |
| 1109 | on with any other developers and it continued to be used mostly |
| 1110 | by Hipp himself for over a decade. When Hipp was first writing |
| 1111 | the Fossil version control system in 2006 and 2007, he used |
| 1112 | makeheaders on that project to help simplify the source code. |
| 1113 | As the popularity of Fossil increased, the makeheaders |
| 1114 | that was incorporated into the Fossil source tree became the |
| 1115 | "official" makeheaders implementation. |
| 1116 | </p> |
| 1117 | |
| 1118 | <p> |
| 1119 | As this paragraph is being composed (2016-11-05), Fossil is the |
| 1120 | only project known to Hipp that is still using makeheaders. On |
| 1121 | the other hand, makeheaders has served the Fossil project well and |
| 1122 | there are no plans remove it. |
| 1123 | </p> |
| 1124 | |
| 1125 | <a name="H0018"></a> |
| 1126 | <h2>7.0 Summary And Conclusion</h2> |
| 1127 | |
| 1128 | <p> |
| 1129 | The makeheaders program will automatically generate a minimal header file |
| 1130 | for each of a set of C source and header files, and will |
| 1131 | generate a composite header file for the entire source file suite, |
| 1132 |