ncdc 1.1 released + Q&A updates

dat/ncdc-changelog

@@ -1,3 +1,23 @@
+1.1 - 2011-09-25
+  - Select item in file browser when opened from a search result
+  - Added active_bind setting
+  - Added share_exclude setting
+  - Added download_exclude setting
+  - Added incoming_dir setting
+  - Added autocompletion for the previous values of certain settings
+  - Allow the "connection" setting to be used for ADC as well
+  - Added IP column to user list
+  - Allow sorting on description, email, tag and IP columns in user list
+  - Display upload speeds in the user list of an ADC hub
+  - Added TLS indication to connection list
+  - Mark selected items bold in listings
+  - Allow /reconnect on the main tab to reconnect all hubs
+  - Added slash to base path in partial file lists
+  - Added delay of 5 seconds before reconnecting to a hub
+  - Added recognition of the AP param on ADC
+  - Added support for UserIP2 on NMDC
+  - Removed support for unexpected incoming NMDC connections
+
 1.0 - 2011-09-16
   - Added ncdc(1) and ncdc-gen-cert(1) manual pages
   - Documented settings (/help set <setting>)

dat/ncdc-man

@@ -205,6 +205,9 @@ INTERACTIVE COMMANDS
               Reconnect  to  the  hub.  When  your  nick  or the hub encoding have been
               changed, the new settings will be used after the reconnect.
 
+              This command can also be used on the main tab, in  which  case  all  con‐
+              nected hubs will be reconnected.
+
        /refresh [<path>]
               Initiates  a  refresh. If no argument is given, the complete list will be
               refreshed. Otherwise only the specified directory will be refreshed.  The
@@ -299,6 +302,10 @@ SETTINGS
               Enables  or  disables  active  mode.  Make  sure  to  set `active_ip' and
               `active_port' before enabling active mode.
 
+       active_bind <string>
+              IP address to bind to in active mode. When unset, ncdc will bind  to  all
+              interfaces.
+
        active_ip <string>
               Your public IP address for use in active mode. It is important that other
               clients can reach you using this IP address. If you connect to a  hub  on
@@ -363,12 +370,15 @@ SETTINGS
               well.
 
        connection <string>
-              Set  your  upload speed. The actual format you can use here may vary, but
+              Set  your upload speed. This is just an indication for other users in the
-              in general you can set it to either a plain number for Mbit/s (e.g.  `50'
+              hub so that they know what speed they can expect  when  downloading  from
-              for  50  mbit)  or a number with a `KiB/s' indicator (e.g. `2300 KiB/s').
+              you.  The  actual format you can use here may vary, but it is recommended
-              This is only used when connecting to NMDC hubs, and is just an indication
+              to set it to either a plain number for Mbit/s (e.g. `50' for 50 mbit)  or
-              for  other  users in the hub so that they know what speed they can expect
+              a  number  with  a `KiB/s' indicator (e.g. `2300 KiB/s'). On ADC hubs you
-              when downloading from you.
+              must use one of the previously mentioned  formats,  otherwise  no  upload
+              speed  will  be  broadcasted.  This  setting is broadcasted as-is on NMDC
+              hubs, to allow for using  old-style  connection  values  (e.g.  `DSL'  or
+              `Cable') on hubs that require this.
 
        description <string>
               A  short  public description that will be displayed in the user list of a
@@ -377,10 +387,19 @@ SETTINGS
        download_dir <path>
               The directory where finished downloads are moved to.  Finished  downloads
               are  by  default stored in <session directory>/dl/. It is possible to set
-              this  to  a  location  that is on a different filesystem than the session
+              this to a location that is on a different filesystem  than  the  incoming
               directory,  but  doing so is not recommended: ncdc will block when moving
               the completed files to their final destination.
 
+       download_exclude <regex>
+              When recursively adding a directory to the download queue -  by  pressing
+              `b'  on  a  directory in the file list browser - any item in the selected
+              directory with a name that matches this regular expression  will  not  be
+              added to the download queue.
+
+              This  regex  is  not checked when adding individual files from either the
+              file list browser or the search results.
+
        download_slots <integer>
               Maximum number of simultaneous downloads.
 
@@ -403,6 +422,11 @@ SETTINGS
               and  is  only  used within ncdc itself. This is the same name as given to
               the `/open' command.
 
+       incoming_dir <path>
+              The directory where incomplete downloads are  stored.  This  setting  can
+              only  be  changed  when  the  download queue is empty. Also see the down‐
+              load_dir setting.
+
        log_debug <boolean>
               Log debug messages to stderr.log in the session directory. It  is  highly
               recommended  to enable this setting if you wish to debug or hack ncdc. Be
@@ -441,6 +465,11 @@ SETTINGS
               `/password' command instead. Passwords are saved unencrypted in the  con‐
               fig file.
 
+       share_exclude <regex>
+              Any  file  or  directory with a name that matches this regular expression
+              will not be shared. A file list refresh is required for this  setting  to
+              be effective.
+
        share_hidden <boolean>
               Whether  to share hidden files and directories. A `hidden' file or direc‐
               tory is one of which the file name starts with a dot. (e.g. `.bashrc'). A
@@ -560,12 +589,13 @@ KEY BINDINGS
               k/j          Select one item up/down.
               PgUp/PgDown  Select one page of items up/down.
               End/Home     Select last/first item in the list.
-              s            Order by share size.
-              u            Order by username.
               o            Toggle sorting OPs before others.
-              t            Toggle tag column visibility.
+              s/S          Order by share size.
-              e            Toggle email column visibility.
+              u/U          Order by username.
-              c            Toggle connection column visibility.
+              t/T          Toggle visibility / order by tag column.
+              e/E          Toggle visibility / order by email column.
+              c/C          Toggle visibility / order by connection column.
+              p/P          Toggle visibility / order by IP column.
               i/Return     Toggle information box.
               m            Send a PM to the selected user.
               g            Grant a slot to the selected user.
@@ -615,8 +645,9 @@ FILES
               Command history.
 
        $NCDC_DIR/inc/
-              Location  for incomplete downloads. File names are the base32-encoded TTH
+              Default location for  incomplete  downloads.  Can  be  changed  with  the
-              root of the completed file.
+              `incoming_dir'  setting.  The  file  names  in  this  directory  are  the
+              base32-encoded TTH root of the completed file.
 
        $NCDC_DIR/logs/
               Directory where all the log files are stored. File  names  starting  with
@@ -657,4 +688,4 @@ SEE ALSO
 
 
 
-ncdc-1.0                             September 2011                             ncdc(1)
+ncdc-1.1                             September 2011                             ncdc(1)

index.cgi

@@ -53,6 +53,7 @@ sub home {
    E;
   end;
   h2 'Updates';
+  b '2011-09-25'; txt ' ncdc 1.1 released!'; br;
   b '2011-09-16'; txt ' ncdc 1.0 released!'; br;
   b '2011-09-15'; txt ' Added some screenshots for ncdu.'; br;
   b '2011-09-03'; txt ' ncdc 0.9 released!'; br;
@@ -226,8 +227,8 @@ sub ncdc {
 
   h2 'Get ncdc!';
   p;
-   b 'Latest version:'; txt ' 1.0 (';
+   b 'Latest version:'; txt ' 1.1 (';
-   a href => '/download/ncdc-1.0.tar.gz', 'download';
+   a href => '/download/ncdc-1.1.tar.gz', 'download';
    txt ' - '; a href => '/ncdc/changes', 'changes';
    txt ' - '; a href => '/download/ncdc.md5', 'md5';
    txt ' - '; a href => '/download/ncdc.sha1', 'sha1';
@@ -372,11 +373,30 @@ sub ncdcfaq {
    E;
   end;
 
+  h2 'Are there any programs available for analyzing the transfers.log file?';
+  p;
+   lit <<'   E;';
+    Nothing like that is included in the release yet, but there is a simple
+    Perl script available: <a
+    href="http://p.blicky.net/agolr">ncdc-transfer-stats</a>.
+   E;
+  end;
+
+  h2 'Why doesn\'t ncdc rotate log files automatically?';
+  p;
+   lit <<'   E;';
+    Because you can easily do that yourself. You can either use logrotate or a
+    simple script that runs from a cron. For an example of the latter option,
+    <a href="http://p.blicky.net/s7132">this is the script I use</a>, which is
+    run as a monthly cron job.
+   E;
+  end;
+
   h2 'What protocol features does ncdc support?';
   p;
    lit <<'   E;';
     For ADC: BASE, RF, TIGR, BZIP, ADCS and KEYP.<br />
-    For NMDC: NoGetINFO, NoHello, MiniSlots, XmlBZList, ADCGet, TTHL and TTHF.<br />
+    For NMDC: NoGetINFO, NoHello, UserIP2, MiniSlots, XmlBZList, ADCGet, TTHL and TTHF.<br />
     That is pretty much everything you'd expect any modern client to have. Note
     that ncdc does not support some of the older NMDC protocol features, like $Get,
     $GetZBlock, $CHUNK, $Cancel or non-XML file lists. I am not aware of an