conversion. Other required libraries are bundled with FMS.\r
\r
To compile, run these commands from the source directory:\r
-cmake .\r
+cmake -D I_HAVE_READ_THE_README=ON .\r
make\r
\r
If you want to use the bundled SQLite3 library, add a -D USE_BUNDLED_SQLITE=ON\r
-to the cmake command. To do charset conversion to UTF-8 when sending messages,\r
-add a -D DO_CHARSET_CONVERSION=ON.\r
+to the cmake command. Use of the bundled SQLite3 library is on by default when\r
+compiling on a Mac. To turn off charset conversion to UTF-8 when sending\r
+messages, add a -D DO_CHARSET_CONVERSION=OFF. Compiling with charset\r
+conversion turned on is recommended.\r
\r
UPGRADING\r
---------\r
-It is always a good idea to make copies of your current FMS installation before\r
-continuing. First shut down FMS and then replace the binary and templates with\r
-those from the new version. You may keep the same database unless otherwise\r
-noted.\r
+It is always a good idea to make a copy of your current FMS installation before\r
+continuing. First shut down FMS, make a copy of the directory, and then\r
+replace all files except the database with those from the new version. You may\r
+keep the same database unless otherwise noted.\r
\r
INSTALLATION\r
------------\r
-Place the binary and any templates in a directory of your choice. On the first\r
-run, a database file will also be created in this directory. Make sure the\r
-user that runs FMS has read/write access to this directory.\r
+Place the binary and any templates in a directory of your choice. Windows\r
+users may need to download the runtime DLLs available from the fms Freesite and\r
+place in the fms directory if they are not already installed on the system. On\r
+the first run, a database file will also be created in this directory. Make\r
+sure the user that runs FMS has read/write access to this directory.\r
\r
RUNNING\r
-------\r
template by placing an HTML file called identityname-template.htm in the same\r
directory as the fms binary. In the template, the string [LINKS] will be\r
replaced by a <ul> list of links and [CONTENT] will be replaced by the page\r
-content. The Freesite will be inserted once a day and contain your last 10\r
-posts and your trust list if you are publishing it. The site will be inserted\r
-to a USK accessible via: USK@yourpublickey.../fms/0/\r
+content. [IDENTITYNAME] will be replaced by the name of the identity inserting\r
+the Freesite. The Freesite will be inserted once a day and contain your last\r
+10 posts and your trust list if you are publishing it. The site will be\r
+inserted to a USK accessible via: USK@yourpublickey.../fms/0/\r
\r
You may add extra files to your Freesite by creating a file called identityname-\r
files.txt that contains a list of files to add to the Freesite. There should\r
NNTP EXTENSIONS\r
---------------\r
The following commands are available through the NNTP connection. The client\r
-must have authenticated for the commands to work.\r
+must have authenticated for the commands to work. Comments MUST be surrounded\r
+by ".\r
\r
XSETTRUST MESSAGE userid@keypart val\r
XSETTRUST TRUSTLIST userid@keypart val\r
+XSETTRUST MESSAGECOMMENT userid@keypart "comment"\r
+XSETTRUST TRUSTLISTCOMMENT userid@keypart "comment"\r
\r
Responses:\r
2xx Trust Set\r
\r
XGETTRUST MESSAGE userid@keypart\r
XGETTRUST TRUSTLIST userid@keypart\r
+XGETTRUST PEERMESSAGE userid@keypart\r
+XGETTRUST PEERTRUSTLIST userid@keypart\r
\r
Responses:\r
2xx val\r
5xx Syntax error\r
\r
XGETTRUSTLIST\r
-messagetrust and trustlisttrust will be 0 to 100 or can be the string "null"\r
-without quotes.\r
+trust values will be 0 to 100 or can be the string "null" without quotes.\r
\r
Responses:\r
2xx Trust List Follows\r
-userid@keypart TAB messagetrust TAB trustlisttrust\r
+userid@keypart TAB messagetrust TAB trustlisttrust TAB peermessagetrust TAB peertrustlisttrust TAB messagecomment TAB trustlistcomment\r
.\r
4xx other error\r
projects / fms.git / blobdiff