My proposal for the FreeBSD project is to optimize and/or complete the BSD-licensed text processing tools diff, diff3, sdiff, and mdocml. Much of what I am proposing is to complete the work done by Ben Fiedler in the 2010 GSoC
When completing the diff family, I will consider (1) compatibility with POSIX, (2) with the GNU variant that is used in FreeBSD at the moment and (3) performance.
May 21 - June 17
June 18 - July 1
July 2 - July 18
July 19 - August 5
August 6 – August 12
August 13 - August 20
To test functionality, I will make use of automated test scripts to test all of the functions I am implementing. I will also test functions that are already implemented to be completely sure my changes to the software have not effected the other functions of the particular utility. For every reported problem, I will add a new test case for regression testing later.
For testing compatibility with POSIX standards and the GNU utilities currently in FreeBSD, I will compare the test script outputs of both the BSD-licensed tools and the GNU tools to make sure they produce identically formatted outputs.
I will also benchmark the BSD-licensed tools against the GNU tools for testing performance.
| Item | Status | Notes |
|---|---|---|
| Missing –speed-large-files | INCOMPLETE | Argument is accepted, but makes no functional change |
| Missing –ignore-file-name-case | COMPLETED | |
| Missing –no-ignore-file-name-case | COMPLETED | |
| Missing –strip-trailing-cr | COMPLETED | |
| Missing –normal | COMPLETED | |
| Missing –tabsize | COMPLETE | |
| Missing –unidirectional-new-file | COMPLETED | |
| Missing –from-file | COMPLETED | |
| Missing –to-file | COMPLETED | |
| Missing –help | COMPLETED | |
| Missing –ignore-blank-lines | INCOMPLETE | |
| Missing –ignore-tab-expansion | IN PROGRESS | |
| Missing -v / –version | COMPLETED | |
| Eliminate warnings | COMPLETED | |
| Comment the code | INCOMPLETE | |
| Check GNU compatibility | COMPLETED | All implemented features GNU compatible as of 6/17/2012 |
| Check POSIX conformance | COMPLETED | |
| Missing –line-format options | IN PROGRESS | regex support is available |
| Missing –group-format options | COMPLETE | |
| Missing –group-format | INCOMPLETE | |
| Adapt source to FreeBSD style guidelines | COMPLETE | |
| Tighter integration between diff utilities | IN PROGRESS | zdiff integration in diff. |
| Item | Status | Notes |
|---|---|---|
| Fix -c99 build warnings/errors | COMPLETE | |
| Combine diff-specific args and pipe to diff process | COMPLETE | |
| Fix output indention | COMPLETE | |
| Binary file support | COMPLETE | |
| Adapt source to FreeBSD style guidelines | COMPLETE | |
| .gz file support | COMPLETE | zsdiff |
| Item | Status | Notes |
|---|---|---|
| Replaced ksh script with sh | COMPLETED | |
| -i flag | COMPLETED | |
| -T flag | COMPLETED | |
| -a flag | COMPLETED | |
| –show-all option | INCOMPLETE | |
| –easy-only | INCOMPLETE | |
| –merge | INCOMPLETE | |
| –label | INCOMPLETE | |
| –strip-trailing-cr | COMPLETED | |
| –diff-program | INCOMPLETE | |
| –version | COMPLETED | |
| –help | COMPLETED | |
| Adapt source to FreeBSD style guidelines | COMPLETED |
June 15 UPDATE - For my first two weeks working on mdocml, I tried implementing these features as roff requests, but that was more difficult than I anticipated, and I used the next two weeks studying man/mdoc and began implementing .ns/.rs (no-space mode) and .ti (temporary indent) as man/mdoc macros. As of June 15th, I have not fully completed implementing these macros, but mdocml will still be a secondary focus during this project and I will be trying to finish these macros. Also, I was able to get a list of all man pages that will not compile under mandoc. The list is in my SVN repository.
| Item | Status | Notes |
|---|---|---|
| .ns (no-space mode) | IN PROGRESS | |
| .rs (no-space mode off) | IN PROGRESS | |
| .ti (temporary indent) | IN PROGRESS | |
| .ta (tab settings) | INCOMPLETE |
Defines man's structs and enums, the relevant ones being the index for macros, enum mant.
Begin parsing man macros, seperately for implicit-block macros or explicit-block macros, and creates a man node for each macros.
Post-processing functions for several man macros.
Pre-processing functions for many man macros.
Pre-processing functions for some macros, and post-processing functions for macros that had pre-processing in man_html.
The structure of mdoc is the same as man.
Functions for formatted output, such as inserting new lines, horizontal/vertical spacing, functions for fonts, etc.
Minor pagefaults - 101
Minor pagefaults - 93
Minor pagefaults - 181
Minor pagefaults - 232