Skip to content

Commit

Permalink
Bumped version to 1.4.3
Browse files Browse the repository at this point in the history
  • Loading branch information
zevv committed Jan 2, 2017
1 parent 40e0bcd commit a781edc
Show file tree
Hide file tree
Showing 5 changed files with 94 additions and 26 deletions.
6 changes: 6 additions & 0 deletions ChangeLog
Original file line number Diff line number Diff line change
@@ -1,4 +1,10 @@

1.4.3 (2017-01-02)

- fix: fixed mouse and tooltip coordinates in scrolled CGI
- fix: fixed lmdb read/write locking
- new: added --dry-run option to 'duc index' for testing purposes

1.4.2 (2016-11-20)

- new: default per-user file path is now ~/.config/duc/ducrc
Expand Down
2 changes: 1 addition & 1 deletion configure.ac
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@

AC_PREREQ([2.13])

AC_INIT([duc], [1.4.2], [duc@zevv.nl])
AC_INIT([duc], [1.4.3], [duc@zevv.nl])

LIB_CURRENT=1
LIB_REVISION=0
Expand Down
46 changes: 40 additions & 6 deletions doc/duc.1
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
.\" generated with Ronn/v0.7.3
.\" http://github.com/rtomayko/ronn/tree/0.7.3
.
.TH "DUC" "1" "November 2016" "" ""
.TH "DUC" "1" "January 2017" "" ""
.
.SH "NAME"
\fBduc\fR \- index, query and graph disk usage
Expand All @@ -28,7 +28,7 @@ Duc allows any option to be placed either on the command line or in a configurat
At startup duc tries to read its configuration from three locations in this particular order: \fB/etc/ducrc\fR, \fB~/\.config/duc/ducrc\fR, \fB~/\.ducrc\fR and \fB\./\.ducrc\fR\.
.
.P
A configuration file consists of sections and parameters\. The section names correspond to the duc subcommands for which the parameters in that section apply\. A section begins with the name of the section in square brackets and continues until the next section begins\.Sections contain parameters, one per line, which consist of a single option name for boolean flags, or an option name and a value for options which take a value\. See the EXAMPLES section for an example of the configuration file format\.
A configuration file consists of sections and parameters\. The section names correspond to the duc subcommands for which the parameters in that section apply\. A section begins with the name of the section in square brackets and continues until the next section begins\. Sections contain parameters, one per line, which consist of a single option name for boolean flags, or an option name and a value for options which take a value\. See the EXAMPLES section for an example of the configuration file format\.
.
.SH "CREATING THE INDEX"
Duc needs an index file of the file system before it is able to show any information\. To create the index, run the \fBduc index\fR command\. For example, to create an index of your home directory run \fBduc index ~\fR
Expand Down Expand Up @@ -64,7 +64,7 @@ Duc has various subcommands for querying or exploring the index:
\fBduc ls\fR lists all files and directories under the given path on the console\.
.
.IP "\(bu" 4
\fBduc ui\fR runs a ncurses based console user interface for exploring the file system usage
\fBduc ui\fR runs a ncurses based console user interface for exploring the file system usage\.
.
.IP "\(bu" 4
\fBduc gui\fR starts a graphical (X11) interface representing the file system in a sunburst graph\. Click on a directory to redraw the graph from the perspective of the selected directory\. Click in the center of the graph to go up one directory in the tree\.
Expand Down Expand Up @@ -155,6 +155,10 @@ skip directories on different file systems
show progress during indexing
.
.TP
\fB\-\-dry\-run\fR
do not update database, just crawl
.
.TP
\fB\-\-uncompressed\fR
do not use compression for database\. Duc enables compression if the underlying database supports this\. This reduces index size at the cost of slightly longer indexing time
.
Expand Down Expand Up @@ -525,7 +529,7 @@ The HTML page is generated with a simple embedded CSS style sheet\. If the style
Add the option \-\-list to generate a table of top sized files and directories in the HTML page\.
.
.IP "\(bu" 4
The options \-\-header and \-\-footer allow you to insert your own HTML code before and after the main
The options \-\-header and \-\-footer allow you to insert your own HTML code before and after the main\.
.
.IP "" 0
.
Expand Down Expand Up @@ -553,17 +557,47 @@ The default mode used by duc is to use the \'actual size\'\. Most duc commands t
If you use git clone to pull down the latest release, you will have to do the following:
.
.P
git clone https://github\.com/zevv/duc cd duc aclocal automake \-\-add\-missing \-c
git clone https://github\.com/zevv/duc
.
.br
cd duc
.
.br
aclocal
.
.br
automake \-\-add\-missing \-c
.
.P
Then you can run the regular
.
.P
\&\./configure [ options ] make
\&\./configure [ options ]
.
.br
make
.
.P
to the regular build of the software\.
.
.P
A note for Redhat and derivates users\. The package providing the development file for lmdb (lmdb\-devel) does not include a lmdb\.pc pkgconfig file\. This could lead to errors during the configure phase:
.
.P
checking for LMDB\.\.\. no
.
.br
configure: error: Package requirements (lmdb) were not met:
.
.P
To avoid the need to call pkg\-config, you may set the environment variables
.
.br
LMDB_CFLAGS and LMDB_LIBS:
.
.P
LMDB_CFLAGS=" " LMDB_LIBS=\-llmdb \./configure \-\-with\-db\-backend=lmdb [ options ]
.
.SH "EXAMPLES"
Index the /usr directory, writing to the default database location ~/\.duc\.db:
.
Expand Down
33 changes: 23 additions & 10 deletions doc/duc.1.html

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

33 changes: 24 additions & 9 deletions doc/duc.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ particular order: `/etc/ducrc`, `~/.config/duc/ducrc`, `~/.ducrc` and
A configuration file consists of sections and parameters. The section names
correspond to the duc subcommands for which the parameters in that section
apply. A section begins with the name of the section in square brackets and
continues until the next section begins.Sections contain parameters, one per
continues until the next section begins. Sections contain parameters, one per
line, which consist of a single option name for boolean flags, or an option name
and a value for options which take a value. See the EXAMPLES section for an
example of the configuration file format.
Expand Down Expand Up @@ -79,7 +79,7 @@ Duc has various subcommands for querying or exploring the index:
* `duc ls` lists all files and directories under the given path on the console.

* `duc ui` runs a ncurses based console user interface for exploring the file
system usage
system usage.

* `duc gui` starts a graphical (X11) interface representing the file system in
a sunburst graph. Click on a directory to redraw the graph from the
Expand Down Expand Up @@ -164,6 +164,9 @@ Options for command `duc index [options] PATH ...`:
* `-p`, `--progress`:
show progress during indexing

* `--dry-run`:
do not update database, just crawl

* `--uncompressed`:
do not use compression for database. Duc enables compression if the underlying database supports this. This reduces index size at the cost of slightly longer indexing time

Expand Down Expand Up @@ -470,7 +473,7 @@ Some notes:
in the HTML page.

* The options --header and --footer allow you to insert your own HTML code
before and after the main <div>.
before and after the main.

The current CGI configuration is not very flexible, nor secure. It is not
advised to run the CGI from public reachable web servers, use at your own risk.
Expand Down Expand Up @@ -508,18 +511,30 @@ key to toggle.
If you use git clone to pull down the latest release, you will have to
do the following:

git clone https://github.com/zevv/duc
cd duc
aclocal
automake --add-missing -c
git clone https://github.com/zevv/duc
cd duc
aclocal
automake --add-missing -c

Then you can run the regular

./configure [ options ]
make
./configure [ options ]
make

to the regular build of the software.

A note for Redhat and derivates users. The package providing the development file
for lmdb (lmdb-devel) does not include a lmdb.pc pkgconfig file. This could lead to
errors during the configure phase:

checking for LMDB... no
configure: error: Package requirements (lmdb) were not met:

To avoid the need to call pkg-config, you may set the environment variables
LMDB_CFLAGS and LMDB_LIBS:

LMDB_CFLAGS=" " LMDB_LIBS=-llmdb ./configure --with-db-backend=lmdb [ options ]

## EXAMPLES


Expand Down

0 comments on commit a781edc

Please sign in to comment.