From 6eb9b8bc4f5c5a261ed881e0127258d7c0df2ac3 Mon Sep 17 00:00:00 2001 From: Curtis McEnroe Date: Fri, 12 Oct 2018 15:07:33 -0400 Subject: Replace torus.7 with torus.1 --- README | 62 ++++++++++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 48 insertions(+), 14 deletions(-) (limited to 'README') diff --git a/README b/README index e7f3e3b..c4f2494 100644 --- a/README +++ b/README @@ -1,22 +1,56 @@ -TORUS(7) FreeBSD Miscellaneous Information Manual TORUS(7) +torus(1) FreeBSD General Commands Manual torus(1) NAME - torus – welcome to ascii.town! + server, client, image, meta, merge – collaborative ASCII art + +SYNOPSIS + server [-d data] [-s sock] + client [-h] [-s sock] + image [-d data] [-f font] [-x x] [-y y] + meta + merge data1 data2 data3 DESCRIPTION + server maps a data file and listens on a UNIX-domain socket to + synchronize events between clients. + + client connects to a UNIX-domain socket and presents a curses(3) + interface. + + image renders a tile from a data file using a PSF2 font to PNG on + standard output. + + meta extracts metadata from a data file on standard input to CSV on + standard ouput. The CSV fields are tileX, tileY, createTime, + modifyCount, modifyTime, accessCount, accessTime. + + merge interactively merges two data files data1 and data2 into data3. + Differing tiles are presented in a curses(3) interface and are chosen by + typing a or b. + + The arguments are as follows: + + -d data + Set path to data file. The default path is torus.dat. + + -f font + Set path to PSF2 font. The default path is default8x16.psfu. + + -h Write help page data to standard output and exit. + + -s sock + Set path to UNIX-domain socket. The default path is torus.sock. + + -x x -y y + Set tile coordinates to render. The default coordinates are + 32,32. + +IMPLEMENTATION NOTES This software targets FreeBSD and Darwin. - torus.h Shared structures and message protocol. - server.c Maps torus.dat and listens on torus.sock. - client.c curses(3) client. - help.h Tile data for help page. - image.c Renders PNGs of tiles. - meta.c Exports metadata from data file to CSV. - merge.c Interactively merges two data files. - snapshot.sh Snapshots data file, appropriate for cron. + help.h contains tile data for the help page and can be generated from the + first tile of torus.dat. - sshd_config Anonymous login to chroot(8)'d client. - index.html Friendly directions. - default8x16.psfu Bitmap font from kbd: http://kbd-project.org. + default8x16.psfu is taken from kbd: http://kbd-project.org. -Causal Agency October 10, 2018 Causal Agency +Causal Agency October 12, 2018 Causal Agency -- cgit 1.4.1 d>Allow for arguments to open/copy utilitiesJune McEnroe 2020-02-12Handle RPL_AWAYJune McEnroe 2020-02-11Support monochromatic terminalsJune McEnroe 2020-02-11Add .gz to chroot-man scriptJune McEnroe 2020-02-11Add -R restricted flagJune McEnroe 2020-02-11Add chroot targetJune McEnroe 2020-02-11Exit focus and paste modes on err exitJune McEnroe 2020-02-11Add startup GPLv3 note and URLJune McEnroe 2020-02-11Make sure -D_GNU_SOURCE ends up in CFLAGS on LinuxJune McEnroe 2020-02-11Add note about setting PKG_CONFIG_PATHJune McEnroe 2020-02-11Rename query ID on nick changeJune McEnroe 2020-02-11Call completeClear when closing a windowJune McEnroe 2020-02-11Don't insert color codes for non-mentionsJune McEnroe 2020-02-11Take first two words in colorMentionsJune McEnroe 2020-02-11Use time_t for save signatureJune McEnroe 2020-02-11Set self.nick to * initiallyJune McEnroe 2020-02-11Define ColorCap instead of hardcoding 100June McEnroe 2020-02-11Move hash to top of chat.hJune McEnroe 2020-02-11Move base64 out of chat.hJune McEnroe 2020-02-11Move XDG_SUBDIR out of chat.hJune McEnroe 2020-02-11Fix whois idle unit calculationJune McEnroe 2020-02-11Cast towupper to wchar_tJune McEnroe 2020-02-11Cast set but unused variables to voidJune McEnroe 2020-02-11Declare strlcatJune McEnroe 2020-02-11Check if VDSUSP existsJune McEnroe 2020-02-11Fix completeReplace iterationJune McEnroe 2020-02-11Use pkg(8) to configure on FreeBSDJune McEnroe 2020-02-11Remove legacy codeJune McEnroe 2020-02-11Add INSTALLING section to READMEJune McEnroe