# HG changeset patch # User markus schnalke # Date 1342375214 -7200 # Node ID d83ab437e3a6b7fe9a8bc616cec12b9ed38af983 # Parent b0e83cfde2bf3dfc97d519946e18ee5fb978b41b Removed FIXMEs (XXX) in the sources, those that I won't fix. diff -r b0e83cfde2bf -r d83ab437e3a6 discussion.roff --- a/discussion.roff Sun Jul 15 19:46:35 2012 +0200 +++ b/discussion.roff Sun Jul 15 20:00:14 2012 +0200 @@ -91,7 +91,6 @@ .P Usually, the limiting resource in the community development of free software is man power. -.\" XXX FIXME ref! If the development effort is spread over a large development area, it becomes more difficult to compete with the specialists in the various fields. @@ -190,7 +189,6 @@ .P As it had already been possible to use an external MSA and MRA, why should the internal version not be kept for convenience? -.\" XXX commas correct? Transfered to a different area, the question, whether there is sense in having a fall-back pager in all the command line tools for the cases when @@ -255,7 +253,6 @@ .LI 3 By depending on a program that provides the function. .LP -.\" XXX Rework sentence While implementing the function in the project itself leads to the largest increase in code size and requires the most maintenance and development work, @@ -267,7 +264,6 @@ External libraries are more strongly connected than external programs, thus information can be exchanged in a more flexible manner. Adding code to a project increases maintenance work. -.\" XXX ref As implementing complex functions in the project itself adds a lot of code, this should be avoided if possible. Thus, the dependencies only change in their character, @@ -320,7 +316,6 @@ A tool like .Pn conflict is surely useful, but it should not be shipped with mmh. -.\" XXX historic reasons? .BU .Pn rcvtty was removed @@ -339,7 +334,6 @@ VE .BU .Pn viamail -.\" XXX was macht viamail was removed .Ci eda72d6a7a7c20ff123043fb7f19c509ea01f932 when the new attachment system was activated, because @@ -352,7 +346,6 @@ .Ci 0e82199cf3c991a173e0ac8aa776efdb3ded61e6 .BU .Pn msgchk -.\" XXX was macht msgchk was removed .Ci bb9360ead7eb7a3fedcce2eeedfc660014e41dbe , because it lost its use case when POP support was removed. @@ -465,7 +458,6 @@ .Id mhshow .P Since the very beginning, already in the first concept paper, -.\" XXX ref!!! .Pn show had been MH's message display program. .Pn show @@ -582,7 +574,6 @@ .Pn show first (cf. Sec. .Cf mhshow ). -.\" XXX code commits? Once the tools behaved more alike, the replacing appeared to be even more natural. Today, mmh's new @@ -599,24 +590,9 @@ hurts in one regard: It had been such a simple program. Its lean elegance is missing from the new .Pn show , -.\" XXX -however there is no alternative; +but there is no alternative; supporting MIME demands higher essential complexity. -.ig -XXX -Consider including text on scan listings here - -Scan listings shall not contain body content. Hence, removed this feature. -Scan listings shall operator on message headers and non-message information -only. Displaying the beginning of the body complicates everything too much. -That's no surprise, because it's something completely different. If you -want to examine the body, then use show(1)/mhshow(1). -Changed the default scan formats accordingly. -.Ci 70b2643e0da8485174480c644ad9785c84f5bff4 -.. - - .H2 "Configure Options @@ -680,7 +656,6 @@ default SMTP servers could be specified .Ci 128545e06224233b7e91fc4c83f8830252fe16c9 . Both of them became irrelevant when the SMTP transport service was removed. -.\" XXX code ref In mmh, all messages are handed over to .Pn sendmail for transportation. @@ -691,7 +666,6 @@ The backup prefix is the string that was prepended to message filenames to tag them as deleted. By default it had been the comma character (`\fL,\fP'). -.\" XXX Zeitlich ordnen In July 2000, Kimmo Suominen introduced the configure option .Sw --with-hash-backup @@ -849,7 +823,7 @@ .Ci ecd6d6a20cb7a1507e3a20d6c4cb3a1cf14c6bbf . The change removed functionality but that is considered minor to the improvement of dropping the dependency and the complex autoconf code. -.\" XXX argument: slocal ist sowieso nicht teil vom mmh kern + .U3 "MH-E Support .P @@ -952,8 +926,7 @@ .Pn spost had not supported it yet. Username extensions can be used in mmh, but less convenient. -.\" XXX covered by next paragraph -.\" XXX format file %(getenv USERNAME_EXTENSION) +.\" XXX In the format file: %(getenv USERNAME_EXTENSION) .Ci 2abae0bfd0ad5bf898461e50aa4b466d641f23d9 .P The @@ -1009,7 +982,6 @@ .P The command line switches of MH tools follow a style similar to the X Window System style. -.\" XXX ref The switches consist of a single dash (`\fL-\fP') followed by a word. For example .Cl -truncate . @@ -1047,7 +1019,6 @@ Changing the behavior of programs provides flexibility and customization to users, but at the same time it complicates the code, the documentation, and the usage of the program. -.\" XXX: Ref Therefore, the number of switches should be kept small. A small set of well-chosen switches is best. Usually, the number of switches increases over time. @@ -1641,7 +1612,6 @@ .LP I did so already in the months before. I pushed forward. -.\" XXX semicolon ? I simply dropped the cruft. .P The decision to drop a feature was based on literature research and @@ -1654,7 +1624,6 @@ I was quick in dropping parts. I rather include falsely dropped parts again, than going at a slower pace. Mmh is experimental work; it requires tough decisions. -.\" XXX ``exp. work'' schon oft gesagt .U3 "Process Forking @@ -1893,7 +1862,6 @@ MH's MIME support is a direct implementation of the RFCs. The perception of the topic described in the RFCs is clearly visible in MH's implementation. -.\" XXX rewrite ``no idea''. As a result, MH had all the MIME features but no idea of attachments. But users do not need all the MIME features, @@ -2190,8 +2158,6 @@ Instead, information on how to retrieve them is output. Not supporting this rare case saved nearly one thousand lines of code .Ci 55e1d8c654ee0f7c45b9361ce34617983b454c32 . -.\" XXX mention somewhere else too: (The profile entry `nmh-access-ftp' -.\" and sbr/ruserpass.c for reading ~/.netrc are gone now.) The MIME type `application/octet-stream; type=tar' is not special anymore. The automatically extracting of such MIME parts had been the dangerous part of the @@ -2269,11 +2235,6 @@ .Pe mhshow-show-* profile entries before, if this is possible and wanted. A common example for this are PDF files. -.ig \"XXX -.Pe mhshow-show-* -profile entries can be used to display MIME parts in a specific way. -to display them in the terminal. -.. In mmh, MIME parts are always displayed serially. The request to display the MIME type `multipart/parallel' in parallel is ignored. @@ -3303,7 +3264,6 @@ path name. The result is a pointer to static memory. .P -.\" XXX ueberfluessig? The new functions have names that indicate their use. Two of the functions convert relative to absolute path names of the same type. @@ -3600,7 +3560,6 @@ if systems do not support these standardized and widespread functions. This compromise is made because mmh focuses on the future. .P -.\" XXX kuerzen und mit dem naechsten Absatz vereinen As I am still in my twenties, have no programming experience from past decades. I have not followed the evolution of C through time. @@ -3866,7 +3825,6 @@ 21 programs depend on one source file only. (These numbers and the ones in the following text ignore the MH library as well as shell scripts and multiple names for the same program.) -.\" XXX graph .P Splitting the source code of a large program into multiple files can increase the readability of its source code,