22 | | You can use [wiki:TracAdmin trac-admin] to configure |
23 | | [http://trac.edgewall.org/ Trac] to better fit your project, especially in |
24 | | regard to ''components'', ''versions'' and ''milestones''. |
| 12 | The plugin is opensourced and free for use with a registered/trial version of NetDrive for OS/2 (see NetDrive for OS/2 license agreement). |
| 13 | |
| 14 | NetDrive 3.x is required. |
| 15 | |
| 16 | == Source code == |
| 17 | The plugin is based on the neon library and also includes OpenSSL and EXPAT libraries. The neon library is released under the LGPL license NetDrive related source code comes with MIT license. |
| 18 | To get plugin sources, please see the CVS page. |
| 19 | |
| 20 | == Compiling == |
| 21 | To compile the code you need OpenWatcom 1.3 compiler and OS/2 Developers Toolkit 4.52. |
| 22 | Do a nmake from plugin directory and everything should be built. Plugin files will be placed to bin subdirectory. |
| 23 | nmake clean will delete all generated files (*.obj, etc) |
| 24 | |
| 25 | == Using the plugin == |
| 26 | This plugin is not yet complete and requires some more features to be in production quality but I hope that it will be useful for some people. |
| 27 | Also I hope that the plugin will be a help for developers who would like to create a custom NetDrive plugin. |
| 28 | All basic features has been implemented. |
| 29 | The plugin supports password authentication and works with SSL. |
| 30 | To enable SSL you have to use 'https' in URL in resource properties: https://servername/directory |
| 31 | Please be aware that write may not work well. Writing files works only with Apache 2.0 and mod_dav. |
| 32 | Do NOT write files on WebFolders or Novell NetStorage! This will destroy file content! |
| 33 | Please be careful and do not access important files with the plugin. |
| 34 | |
| 35 | == For developers and users willing to help == |
| 36 | Here is a short list of missing features. You are encouraged to implement them. |
| 37 | * local file cache for better performance |
| 38 | * http proxy support. neon already supports proxies so the plugin just have to use this functionality. |
| 39 | * implement write for servers that do not support PUT with Content-Range. This has to be done by caching file locally and uploading entire file when file is closed. AFAIK only Apache + mod_dav supports Content-Range for PUT. |
| 40 | * write help, documentation |
| 41 | |
| 42 | == Bugs == |
| 43 | NOTE: OS/2 version of mod_dav has a bug and will DESTROY content of a file when PUT with Content_Range is processed. Fix for this is very simple, - remove a couple of lines from Apache Portable Runtime OS/2 source code, - but it does not look like Apache developers really care about OS/2 platform. See http://issues.apache.org/bugzilla/show_bug.cgi?id=33844 |