From 60f4618e2be0229e966a2c8e9bf5ca4f5cd70944 Mon Sep 17 00:00:00 2001 From: Christian Neukirchen Date: Mon, 1 Aug 2016 19:33:25 +0200 Subject: rename project to mblaze --- COPYING | 2 +- Makefile | 2 +- README | 34 ++++++------ man/mblaze.7 | 168 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++ man/mintro.7 | 171 ----------------------------------------------------------- man/mmsg.7 | 2 +- 6 files changed, 188 insertions(+), 191 deletions(-) create mode 100644 man/mblaze.7 delete mode 100644 man/mintro.7 diff --git a/COPYING b/COPYING index a461a9b..5486574 100644 --- a/COPYING +++ b/COPYING @@ -1,4 +1,4 @@ -Santoku is in the public domain. +mblaze is in the public domain. To the extent possible under law, Christian Neukirchen diff --git a/Makefile b/Makefile index 37701d0..6ba6dac 100644 --- a/Makefile +++ b/Makefile @@ -21,7 +21,7 @@ mshow: mshow.o blaze822.o seq.o rfc2045.o rfc2047.c mymemmem.o filter.o msort: msort.o blaze822.o seq.o mystrverscmp.o mymemmem.o mthread: mthread.o blaze822.o seq.o mymemmem.o -README: man/mintro.7 +README: man/mblaze.7 mandoc -Tutf8 $< | col -bx >$@ clean: FRC diff --git a/README b/README index 1766610..6ef30da 100644 --- a/README +++ b/README @@ -1,16 +1,16 @@ -MINTRO(7) Miscellaneous Information Manual MINTRO(7) +MBLAZE(7) Miscellaneous Information Manual MBLAZE(7) NAME - mintro – Santoku introduction + mblaze – introduction to mblaze DESCRIPTION - The Santoku message system is a set of Unix utilities to deal with mail + The mblaze message system is a set of Unix utilities to deal with mail kept in Maildir folders. Its design is roughly inspired by MH, the RAND Message Handling System, but its is a complete implementation from scratch. - Santoku consists of a set of Unix tools that each do one job: + mblaze consists of a set of Unix tools that each do one job: maddr(1) to extract addresses from mail mcomp(1) to write and send mail mdeliver(1) to deliver messages or import mailboxes @@ -32,13 +32,13 @@ DESCRIPTION mthread(1) to arrange mail into discussions PRINCIPLES - Santoku is a classic command line MUA with no features related to + mblaze is a classic command line MUA with no features related to receiving and transferring mail. You are expected to fetch your mail using offlineimap(1), fdm(1), procmail(1), getmail(1) or similar and send it using sendmail(8), as provided by OpenSMTPD, Postfix, msmtp(1), dma(8) - or similar. Santoku expects your mail to reside in Maildir folders. + or similar. mblaze expects your mail to reside in Maildir folders. - Santoku operates directly on Maildir and doesn't use caches or database. + mblaze operates directly on Maildir and doesn't use caches or database. There is no setup needed for many uses. All tools have been written with performance in mind. Enumeration of all mails in a Maildir is avoided unless necessary, and then optimized to use few syscalls. Parsing mail @@ -48,20 +48,20 @@ PRINCIPLES wasteful), but whole messages are assumed to fit into RAM easily (at a time). - Santoku has been written from scratch and tested on a big pile of - personal mail, but is not actually 100% RFC conforming (which is neither - worth it nor desirable). There may be issues with very old, - nonconforming, messages. + mblaze has been written from scratch and tested on a big pile of personal + mail, but is not actually 100% RFC conforming (which is neither worth it + nor desirable). There may be issues with very old, nonconforming, + messages. - Santoku is written in portable C, using only POSIX functions (apart from - a tiny Linux-only optimization), and has no external dependencies. It + mblaze is written in portable C, using only POSIX functions (apart from a + tiny Linux-only optimization), and has no external dependencies. It supports MIME and more than 7-bit messages (everything the host iconv(3) - can decode). It assumes you work in a UTF-8 environment. Santoku works + can decode). It assumes you work in a UTF-8 environment. mblaze works well together with other Unix mail tools such as offlineimap(1), mairix(1), or mu(1). EXAMPLES - Santoku tools are designed to be composed together into a pipe. It is + mblaze tools are designed to be composed together into a pipe. It is suitable for interactive use and for scripting. It integrates well into a Unix workflow. @@ -85,7 +85,7 @@ EXAMPLES As usual with pipes, the sky is the limit. CONCEPTS - Santoku deals with messages (which are files), folders (which are Maildir + mblaze deals with messages (which are files), folders (which are Maildir folders), sequences (which are newline-separated lists of messages, possibly persisted on disk in ~/.santoku/seq), and the current message (kept as a symlink in ~/.santoku/cur). @@ -104,7 +104,7 @@ AUTHORS Christian Neukirchen LICENSE - Santoku is in the public domain. + mblaze is in the public domain. To the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work. diff --git a/man/mblaze.7 b/man/mblaze.7 new file mode 100644 index 0000000..16dd325 --- /dev/null +++ b/man/mblaze.7 @@ -0,0 +1,168 @@ +.Dd July 22, 2016 +.Dt MBLAZE 7 +.Os +.Sh NAME +.Nm mblaze +.Nd introduction to mblaze +.Sh DESCRIPTION +The +.Nm +message system is a set of Unix utilities to deal with +mail kept in Maildir folders. +.Pp +Its design is roughly inspired by MH, the RAND Message Handling +System, but its is a complete implementation from scratch. +.Pp +.Nm +consists of a set of Unix tools that each do one job: +.Bl -tag -width 11n -compact +.It Xr maddr 1 +to extract addresses from mail +.It Xr mcomp 1 +to write and send mail +.It Xr mdeliver 1 +to deliver messages or import mailboxes +.It Xr mdirs 1 +to find Maildirs +.It Xr mflag 1 +to change flags (marks) of mail +.It Xr mgenmid 1 +to generate Message-IDs +.It Xr mhdr 1 +to extract mail headers +.It Xr minc 1 +to incorporate new mail +.It Xr mless 1 +to conveniently read mail in +.Xr less 1 +.It Xr mlist 1 +to list and filter mail messages +.It Xr mmime 1 +to create MIME messages +.It Xr mpick 1 +to filter mail +.It Xr mrepl 1 +to reply to mail +.It Xr mscan 1 +to generate single line summaries of mail +.It Xr msed 1 +to manipulate mail headers +.It Xr mseq 1 +to manipulate mail sequences +.It Xr mshow 1 +to render mail and extract attachments +.It Xr msort 1 +to sort mail +.It Xr mthread 1 +to arrange mail into discussions +.El +.Sh PRINCIPLES +.Nm +is a classic command line MUA with no features related to receiving +and transferring mail. +You are expected to fetch your mail using +.Xr offlineimap 1 , +.Xr fdm 1 , +.Xr procmail 1 , +.Xr getmail 1 +or similar +and send it using +.Xr sendmail 8 , +as provided by +OpenSMTPD, +Postfix, +.Xr msmtp 1 , +.Xr dma 8 +or similar. +.Nm +expects your mail to reside in Maildir folders. +.Pp +.Nm +operates directly on Maildir and doesn't use caches or database. +There is no setup needed for many uses. +All tools have been written with performance in mind. +Enumeration of all mails in a Maildir is avoided unless necessary, +and then optimized to use few syscalls. +Parsing mail metadata is optimized to use few I/O requests. +Initial operations on big Maildir may feel slow, but as soon as they +are in cache, everything is blazing fast. +The tools are written to be memory efficient (i.e. not wasteful), but +whole messages are assumed to fit into RAM easily (at a time). +.Pp +.Nm +has been written from scratch and tested on a big pile of personal mail, +but is not actually 100% RFC conforming +(which is neither worth it nor desirable). +There may be issues with very old, nonconforming, messages. +.Pp +.Nm +is written in portable C, using only POSIX functions (apart from a tiny +Linux-only optimization), +and has no external dependencies. +It supports MIME and more than 7-bit messages (everything the host +.Xr iconv 3 +can decode). +It assumes you work in a UTF-8 environment. +.Nm +works well together with other Unix mail tools such as +.Xr offlineimap 1 , +.Xr mairix 1 , +or +.Xr mu 1 . +.Sh EXAMPLES +.Nm +tools are designed to be composed together into a pipe. +It is suitable for interactive use and for scripting. +It integrates well into a Unix workflow. +.Pp +For example, you could decide you want to look at all unseen mail in your +INBOX, oldest first. +.Dl mlist -s ~/Maildir/INBOX | msort -d | mscan +To operate on a set of mails in multiple steps, you can save a list of mail +as a sequence. +E.g. add a call to +.Ql mseq -S +to above command: +.Dl mlist -s ~/Maildir/INBOX | msort -d | mseq -S | mscan +Now mscan will show message numbers and you could look at the first +five mails at once, for example: +.Dl mshow 1:5 +Likewise, you could decide to look at all freshly received mail in all +folders, thread it and look at it interactively: +.Dl mdirs ~/Maildir | xargs minc | mthread | mless +Or you could look at the attachments of the 20 largest mails in your INBOX: +.Dl mlist ~/Maildir/INBOX | msort -s | tail -20 | mshow -t +Or apply the patches from the current mail: +.Dl mshow -O . '*.diff' | patch +As usual with pipes, the sky is the limit. +.Sh CONCEPTS +.Nm +deals with messages (which are files), +folders (which are Maildir folders), +sequences (which are newline-separated lists of messages, possibly persisted on disk in +.Pa ~/.santoku/seq ) , +and the current message (kept as a symlink in +.Pa ~/.santoku/cur ) . +.Pp +Messages in the persisted sequence can be referred to using special +syntax as explained in +.Xr mmsg 7 . +.Pp +Many utilities have a default behavior when used interactively from a terminal +(e.g. operate on the current message or the current sequence). +For scripting, you must make these arguments explicit. +.Sh SEE ALSO +.Xr mailx 1 , +.Xr nmh 7 +.Sh AUTHORS +.An Christian Neukirchen Aq Mt chneukirchen@gmail.com +.Sh LICENSE +.Nm +is in the public domain. +.Pp +To the extent possible under law, +the creator of this work +has waived all copyright and related or +neighboring rights to this work. +.Pp +.Lk http://creativecommons.org/publicdomain/zero/1.0/ diff --git a/man/mintro.7 b/man/mintro.7 deleted file mode 100644 index c3074a2..0000000 --- a/man/mintro.7 +++ /dev/null @@ -1,171 +0,0 @@ -.Dd July 22, 2016 -.Dt MINTRO 7 -.Os -.Sh NAME -.Nm mintro -.Nd Santoku introduction -.de N2 -.Nm Santoku -.. -.Sh DESCRIPTION -The -.N2 -message system is a set of Unix utilities to deal with -mail kept in Maildir folders. -.Pp -Its design is roughly inspired by MH, the RAND Message Handling -System, but its is a complete implementation from scratch. -.Pp -.N2 -consists of a set of Unix tools that each do one job: -.Bl -tag -width 11n -compact -.It Xr maddr 1 -to extract addresses from mail -.It Xr mcomp 1 -to write and send mail -.It Xr mdeliver 1 -to deliver messages or import mailboxes -.It Xr mdirs 1 -to find Maildirs -.It Xr mflag 1 -to change flags (marks) of mail -.It Xr mgenmid 1 -to generate Message-IDs -.It Xr mhdr 1 -to extract mail headers -.It Xr minc 1 -to incorporate new mail -.It Xr mless 1 -to conveniently read mail in -.Xr less 1 -.It Xr mlist 1 -to list and filter mail messages -.It Xr mmime 1 -to create MIME messages -.It Xr mpick 1 -to filter mail -.It Xr mrepl 1 -to reply to mail -.It Xr mscan 1 -to generate single line summaries of mail -.It Xr msed 1 -to manipulate mail headers -.It Xr mseq 1 -to manipulate mail sequences -.It Xr mshow 1 -to render mail and extract attachments -.It Xr msort 1 -to sort mail -.It Xr mthread 1 -to arrange mail into discussions -.El -.Sh PRINCIPLES -.N2 -is a classic command line MUA with no features related to receiving -and transferring mail. -You are expected to fetch your mail using -.Xr offlineimap 1 , -.Xr fdm 1 , -.Xr procmail 1 , -.Xr getmail 1 -or similar -and send it using -.Xr sendmail 8 , -as provided by -OpenSMTPD, -Postfix, -.Xr msmtp 1 , -.Xr dma 8 -or similar. -.N2 -expects your mail to reside in Maildir folders. -.Pp -.N2 -operates directly on Maildir and doesn't use caches or database. -There is no setup needed for many uses. -All tools have been written with performance in mind. -Enumeration of all mails in a Maildir is avoided unless necessary, -and then optimized to use few syscalls. -Parsing mail metadata is optimized to use few I/O requests. -Initial operations on big Maildir may feel slow, but as soon as they -are in cache, everything is blazing fast. -The tools are written to be memory efficient (i.e. not wasteful), but -whole messages are assumed to fit into RAM easily (at a time). -.Pp -.N2 -has been written from scratch and tested on a big pile of personal mail, -but is not actually 100% RFC conforming -(which is neither worth it nor desirable). -There may be issues with very old, nonconforming, messages. -.Pp -.N2 -is written in portable C, using only POSIX functions (apart from a tiny -Linux-only optimization), -and has no external dependencies. -It supports MIME and more than 7-bit messages (everything the host -.Xr iconv 3 -can decode). -It assumes you work in a UTF-8 environment. -.N2 -works well together with other Unix mail tools such as -.Xr offlineimap 1 , -.Xr mairix 1 , -or -.Xr mu 1 . -.Sh EXAMPLES -.N2 -tools are designed to be composed together into a pipe. -It is suitable for interactive use and for scripting. -It integrates well into a Unix workflow. -.Pp -For example, you could decide you want to look at all unseen mail in your -INBOX, oldest first. -.Dl mlist -s ~/Maildir/INBOX | msort -d | mscan -To operate on a set of mails in multiple steps, you can save a list of mail -as a sequence. -E.g. add a call to -.Ql mseq -S -to above command: -.Dl mlist -s ~/Maildir/INBOX | msort -d | mseq -S | mscan -Now mscan will show message numbers and you could look at the first -five mails at once, for example: -.Dl mshow 1:5 -Likewise, you could decide to look at all freshly received mail in all -folders, thread it and look at it interactively: -.Dl mdirs ~/Maildir | xargs minc | mthread | mless -Or you could look at the attachments of the 20 largest mails in your INBOX: -.Dl mlist ~/Maildir/INBOX | msort -s | tail -20 | mshow -t -Or apply the patches from the current mail: -.Dl mshow -O . '*.diff' | patch -As usual with pipes, the sky is the limit. -.Sh CONCEPTS -.N2 -deals with messages (which are files), -folders (which are Maildir folders), -sequences (which are newline-separated lists of messages, possibly persisted on disk in -.Pa ~/.santoku/seq ) , -and the current message (kept as a symlink in -.Pa ~/.santoku/cur ) . -.Pp -Messages in the persisted sequence can be referred to using special -syntax as explained in -.Xr mmsg 7 . -.Pp -Many utilities have a default behavior when used interactively from a terminal -(e.g. operate on the current message or the current sequence). -For scripting, you must make these arguments explicit. -.Sh SEE ALSO -.Xr mailx 1 , -.Xr nmh 7 -.Sh AUTHORS -.An Christian Neukirchen Aq Mt chneukirchen@gmail.com -.Sh LICENSE -.N2 -is in the public domain. -.Pp -To the extent possible under law, -the creator of this work -has waived all copyright and related or -neighboring rights to this work. -.Pp -.Lk http://creativecommons.org/publicdomain/zero/1.0/ diff --git a/man/mmsg.7 b/man/mmsg.7 index 9648e7d..e903aa4 100644 --- a/man/mmsg.7 +++ b/man/mmsg.7 @@ -3,7 +3,7 @@ .Os .Sh NAME .Nm mmsg -.Nd Santoku message argument syntax +.Nd mblaze message argument syntax .Sh DESCRIPTION This manpage documents the message syntax used by the tools -- cgit 1.4.1