diff options
author | Andreas Baumann <abaumann@yahoo.com> | 2011-11-05 11:42:17 +0100 |
---|---|---|
committer | Andreas Baumann <abaumann@yahoo.com> | 2011-11-05 11:42:17 +0100 |
commit | f98a0dd6e82020efcfd947d519f0b1258cf56938 (patch) | |
tree | 71bc5db75116348c3f7e235af71ba8a1a4fd1edc | |
parent | e9ff920e10a7f529625a7ba2471b61cc07d21229 (diff) | |
download | wolfbones-f98a0dd6e82020efcfd947d519f0b1258cf56938.tar.gz wolfbones-f98a0dd6e82020efcfd947d519f0b1258cf56938.tar.bz2 |
more docu cleanup
-rw-r--r-- | BUGS (renamed from docs/makefiles/BUGS) | 2 | ||||
-rw-r--r-- | TODOS | 40 | ||||
-rw-r--r-- | docs/makefiles/TODOS | 22 | ||||
-rw-r--r-- | docs/network/README | 14 | ||||
-rw-r--r-- | docs/port/README.networking | 7 | ||||
-rw-r--r-- | docs/port/TODOS | 10 | ||||
-rw-r--r-- | docs/service/TODOS | 6 |
7 files changed, 56 insertions, 45 deletions
diff --git a/docs/makefiles/BUGS b/BUGS index 4318ce5..bbd4f10 100644 --- a/docs/makefiles/BUGS +++ b/BUGS @@ -1,5 +1,7 @@ Known Bugs: +Makefiles + OpenBSD 4.3, more precise gmake 3.80 is buggy, ignore: ../makefiles/depend.mk:27: no file name for `-include' The build process seems to be ok though.. @@ -63,3 +63,43 @@ - Seen links with the actual event number in the event logger with the possibility to send it directly to a bug system (HTML form). This would be great to have! +- makefiles + - GNU make + - currently we are following the "recursive makes considered harmfull" :-) + - distclean calls clean again recurively. This causes already deleted + dependencies to be regenerated + - do shared libraries properly + - add uninstall + - modularize more + - get platform.mk and shell in sync, make sure the user can set the + variables there manually if we wants to + - split things for different compilers and make them individually + handleable + - check out other makefile systems: + - ION-3 + - openradius + - POCO + - problems: + - OpenBSD gmake: ../../makefiles/depend.mk:62: no file name for `-include' + - make -j test with missing testd, some dependencies are missing + - test target calls all target, this should not be necessary + - Windows: + - how to generate dependencies and include them in the NMAKE files? + - how to add the generation of a setup.exe or MSI? +- Porting + - the HAVE_XXX flags could produce a name clash with some autoconf'ed + software/library we will be using in production code. Rename to + WOLF_SYS_HAVE_XXX or similar + - feedback to the c99 snprintf guy, errors like: + - -1 instead of buffer size on boffer overflow + - extern errno in mutli-threaded code + - add a lot more tests + - %zd and similar pointers: make format macros like PRIdPTR which + get mapped to %ld. But what if snprintf could do a %zd and + fprintf not? +- Windows service + - option parsing on windows? + - have a generic message/po-file extractor, the perl script here is + an evil copy! + - handle pause/continue + - test long-duration startup and shutdown phases with checkpoint_hints diff --git a/docs/makefiles/TODOS b/docs/makefiles/TODOS deleted file mode 100644 index 8e64dbc..0000000 --- a/docs/makefiles/TODOS +++ /dev/null @@ -1,22 +0,0 @@ -- GNU make - - currently we are following the "recursive makes considered harmfull" :-) - - distclean calls clean again recurively. This causes already deleted - dependencies to be regenerated - - do shared libraries properly - - add uninstall - - modularize more - - get platform.mk and shell in sync, make sure the user can set the - variables there manually if we wants to - - split things for different compilers and make them individually - handleable - - check out other makefile systems: - - ION-3 - - openradius - - POCO - - problems: - - OpenBSD gmake: ../../makefiles/depend.mk:62: no file name for `-include' - - make -j test with missing testd, some dependencies are missing - - test target calls all target, this should not be necessary -- Windows: - - how to generate dependencies and include them in the NMAKE files? - - how to add the generation of a setup.exe or MSI? diff --git a/docs/network/README b/docs/network/README index a1c4ed6..cad30ac 100644 --- a/docs/network/README +++ b/docs/network/README @@ -44,3 +44,17 @@ Links: - async I/O on files, pipes doesn't work on Windows, there we need the Windows async event interface which doesn't look alike to select - select is very inefficient on Windows and also limited +- use POSIX getaddrinfo/getnameinfo as they provide a good top-level interface which + is quite portable (even on Windows) + +Good code examples: +- UNPV12e of W. Richard Stevens (Unix Network Programming), the must-read +- postgresql has a good getaddrinfo replacement for Windows and Cygwin +- some very helpful tips: www_kame_net_newsletter_19980604.txt +- use POSIX getaddrinfo/getnameinfo as they provide a good top-level interface which + is quite portable (even on Windows) + +Good code examples: +- UNPV12e of W. Richard Stevens (Unix Network Programming), the must-read +- postgresql has a good getaddrinfo replacement for Windows and Cygwin +- some very helpful tips: www_kame_net_newsletter_19980604.txt diff --git a/docs/port/README.networking b/docs/port/README.networking deleted file mode 100644 index c749209..0000000 --- a/docs/port/README.networking +++ /dev/null @@ -1,7 +0,0 @@ -- use POSIX getaddrinfo/getnameinfo as they provide a good top-level interface which - is quite portable (even on Windows) - -Good code examples: -- UNPV12e of W. Richard Stevens (Unix Network Programming), the must-read -- postgresql has a good getaddrinfo replacement for Windows and Cygwin -- some very helpful tips: www_kame_net_newsletter_19980604.txt diff --git a/docs/port/TODOS b/docs/port/TODOS deleted file mode 100644 index ffdb327..0000000 --- a/docs/port/TODOS +++ /dev/null @@ -1,10 +0,0 @@ -- the HAVE_XXX flags could produce a name clash with some autoconf'ed - software/library we will be using in production code. Rename to - WOLF_SYS_HAVE_XXX or similar -- feedback to the c99 snprintf guy, errors like: - - -1 instead of buffer size on boffer overflow - - extern errno in mutli-threaded code -- add a lot more tests -- %zd and similar pointers: make format macros like PRIdPTR which - get mapped to %ld. But what if snprintf could do a %zd and - fprintf not? diff --git a/docs/service/TODOS b/docs/service/TODOS deleted file mode 100644 index a67992a..0000000 --- a/docs/service/TODOS +++ /dev/null @@ -1,6 +0,0 @@ -- option parsing on windows? -- have a generic message/po-file extractor, the perl script here is - an evil copy! -- handle pause/continue -- test long-duration startup and shutdown phases with checkpoint_hints - |