File: README

package info (click to toggle)
randomize-lines 0.2.7
  • links: PTS, VCS
  • area: main
  • in suites: jessie, jessie-kfreebsd, lenny, squeeze, wheezy
  • size: 600 kB
  • ctags: 76
  • sloc: sh: 3,823; ansic: 741; makefile: 73
file content (87 lines) | stat: -rw-r--r-- 3,228 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
rl - Randomize Lines

rl reads lines from a input file or stdin, randomizes the lines and outputs a
specified number of lines. It does this with only a single pass over the input
while trying to use as little memory as possible.

I wrote rl in my spare time mainly to be able to select a random audio file to
play when my toast is done (script in combination with find and sleep).
Another reason was to familiarize myself with autoconf and friends.

The most recent version of rl can be found at
http://ch.tudelft.nl/~arthur/rl/

Warning: The command line options and default behaviour may change between
releases until a 1.0 release is made.

Another Warning: I have mostly lost interest in this project and am not
planning on doing much development on it any more. I will however still accept
patches and fix important bugs (this more or less contradicts the previous
warning).

Note: Users are recommended to use the shuf command instead which has been
part of GNU coreutils since release 6.0.


COPYRIGHT NOTICE
================

Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008 Arthur de Jong

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301 USA


INSTALLATION INSTRUCTIONS
=========================

rl should compile fine on most Unix-like operating systems. It is written to
be as portable as possible.

rl is developed on Debian GNU/Linux 4.0 (etch) and unstable (sid) and tested
on Solaris 8 (once in a while), OpenBSD 2.7 (hardly ever) and HP-UX 10 (a long
time ago).

rl uses a configure script to guess build parameters for your system.
Configuration, compilation and installation should be as simple as this:

  % ./configure   (use --help for options)
  % make          (compile)
  % make install  (install)

For more details read the INSTALL file.


DEVELOPMENT STATUS
==================

Development on rl has slowed down a bit because it works good enough for me.
The software is however not yet in such a state that I would be willing to
label it as a final release because the TODO list contains some important
points (mainly the files with a large number of lines).

Since GNU coreutils 6.0 includes a tool 'shuf' that pretty much does the same
thing (and likely works better with large files) the likelihood of a new
release is small.

A quick comparison between rl and shuf indicates that rl uses less CPU time
(about half) while shuf uses less memory (about a quarter).


REPORTING BUGS
==============

If you find any bugs or missing features please send an email to
  arthur@ch.tudelft.nl
Please include as much information as needed. Patches are more than welcome.