75 lines
1.7 KiB
Groff
75 lines
1.7 KiB
Groff
.\" Manpage for bb.
|
|
.\" Contact bruce@bruce-hill.com to correct errors or typos.
|
|
.TH man 8 "22 May 2019" "1.0" "bb manual page"
|
|
.SH NAME
|
|
bb \- A bitty browser for command line file management
|
|
.SH SYNOPSIS
|
|
.B bb
|
|
[\fI-d\fR]
|
|
[\fI-s\fR]
|
|
[\fI-0\fR]
|
|
[\fI+command... \fR]
|
|
[\fIdirectory\fR]
|
|
.SH DESCRIPTION
|
|
\fBbb\fR is a tiny TUI console application for browsing and managing files.
|
|
.SH OPTIONS
|
|
.B \-d
|
|
Print the current directory on exit.
|
|
|
|
.B \-s
|
|
Print the selected files on exit.
|
|
|
|
.B \-0
|
|
If printing the selected files on exit, use NULL-terminated strings instead of
|
|
newline-separated.
|
|
|
|
.B \-d
|
|
Print the current directory on exit.
|
|
|
|
.B \+command
|
|
From within \fBbb\fR, running \fBbb +command\fR will execute an internal bb
|
|
command for modifying bb's state.
|
|
|
|
.B directory
|
|
Open to this directory.
|
|
|
|
.SH CONTROLS
|
|
For full details on all key bindings, press \fB?\fR from inside \fBbb\fR to get
|
|
a help menu.
|
|
|
|
.TP
|
|
.B Navigating:
|
|
Arrow keys or h/j/k/l can be used to navigate.
|
|
|
|
.TP
|
|
.B Selecting:
|
|
\fBSpace\fR is used to toggle file selection. Actions (such as copying or
|
|
deleting files) are performed on the selected files. If no files are selected,
|
|
actions are performed on the file under the cursor. The selection can be
|
|
cleared by pressing \fBEscape\fR.
|
|
|
|
.TP
|
|
.B Mouse:
|
|
Clicking on a file will move the cursor to it. Double clicking will open it.
|
|
Clicking on the '*' column of a file will toggle that file's selection.
|
|
|
|
.SH EXAMPLES
|
|
.TP
|
|
.B
|
|
bb /usr/local/
|
|
Begin browsing in /usr/local/
|
|
|
|
.TP
|
|
.B
|
|
alias bb="cd '`/usr/local/bin/bb -d || pwd`'"
|
|
Create an alias to launch \fBbb\fR and change directory to wherever it's located
|
|
when you exit (unless you exit with Ctrl-c).
|
|
|
|
.TP
|
|
.B
|
|
bb -s -0 | xargs -0 zip archive.zip
|
|
Select some files to add to a zip archive.
|
|
|
|
.SH AUTHOR
|
|
Bruce Hill (bruce@bruce-hill.com)
|