From patchwork Sun Jan 13 19:17:57 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Johannes_L=C3=B6thberg?= X-Patchwork-Id: 944 Return-Path: Delivered-To: patchwork@archlinux.org Received: from apollo.archlinux.org (localhost [127.0.0.1]) by apollo.archlinux.org (Postfix) with ESMTP id 0C947A87A296 for ; Sun, 13 Jan 2019 19:18:20 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on apollo X-Spam-Level: X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00=-1,DKIM_SIGNED=0.1, DKIM_VALID=-0.1,DKIM_VALID_AU=-0.1,MAILING_LIST_MULTI=-1, RCVD_IN_DNSWL_MED=-2.3 autolearn=ham autolearn_force=no version=3.4.2 X-Spam-BL-Results: [127.0.9.2] Received: from orion.archlinux.org (orion.archlinux.org [IPv6:2a01:4f8:160:6087::1]) by apollo.archlinux.org (Postfix) with ESMTPS for ; Sun, 13 Jan 2019 19:18:18 +0000 (UTC) Received: from orion.archlinux.org (localhost [127.0.0.1]) by orion.archlinux.org (Postfix) with ESMTP id 1A2C2FF67306C; Sun, 13 Jan 2019 19:18:17 +0000 (UTC) Received: from luna.archlinux.org (luna.archlinux.org [IPv6:2a01:4f8:160:3033::2]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange ECDHE (P-384) server-signature RSA-PSS (4096 bits)) (No client certificate requested) by orion.archlinux.org (Postfix) with ESMTPS; Sun, 13 Jan 2019 19:18:17 +0000 (UTC) Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id 05A5A2BEA0; Sun, 13 Jan 2019 19:18:17 +0000 (UTC) Authentication-Results: luna.archlinux.org; dkim=pass (1024-bit key) header.d=kyriasis.com header.i=@kyriasis.com header.b=Upeozap4 Received: from luna.archlinux.org (luna.archlinux.org [127.0.0.1]) by luna.archlinux.org (Postfix) with ESMTP id 5108E2BEA0 for ; Sun, 13 Jan 2019 19:18:13 +0000 (UTC) Received: from theos.kyriasis.com (theos.kyriasis.com [212.71.254.33]) by luna.archlinux.org (Postfix) with ESMTPS for ; Sun, 13 Jan 2019 19:18:13 +0000 (UTC) Received: from theos.kyriasis.com (localhost [127.0.0.1]) by theos.kyriasis.com (OpenSMTPD) with ESMTP id 2062137f for ; Sun, 13 Jan 2019 19:18:10 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=kyriasis.com; h=from:to:cc :subject:date:message-id:mime-version:content-type :content-transfer-encoding; s=theos; bh=A+faO5D9/yzpeD4/uU7YNv6v U3Y=; b=Upeozap4PVKKrHTMqzeKYC+WS/5dtxyulgLgjh/rp1kMSOG0PtnZnz+v MADODG0hsh+So7M2CjR8Dkn2Rcrk/gOXmHh4+hbsCmiEcLR9ZvmkjFMkt5AZKuIU OOPs2nJR2uu3gQYzMrgRmKFpOhJIAtS4g30z0h3ii/U6ddHGcpM= DomainKey-Signature: a=rsa-sha1; c=nofws; d=kyriasis.com; h=from:to:cc :subject:date:message-id:mime-version:content-type :content-transfer-encoding; q=dns; s=theos; b=KWmZe0h6AyCtex7XMR nO3mhoTmX0/enJGVQNwO55Jek1juLpEG6sBQdVdFeU6MdA0UbdFIA4COMV35h3jk ekr/XqyKjdV5iumlx21alIojc1AO+3m0QS28k/X5AdVdOxOBI2KS9ZoBZhligQPl /euprjEoS9goXmybjDfBzfEL0= Received: from hydrogen.kyriasis.com (h-52-10.A572.priv.bahnhof.se [158.174.52.10]) by theos.kyriasis.com (OpenSMTPD) with ESMTPSA id ebe3af78 (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256:NO); Sun, 13 Jan 2019 19:18:05 +0000 (UTC) From: =?utf-8?q?Johannes_L=C3=B6thberg?= To: pacman-contrib@lists.archlinux.org Subject: [PATCH] doc: Add pacsort manpage Date: Sun, 13 Jan 2019 20:17:57 +0100 Message-Id: <20190113191757.24638-1-johannes@kyriasis.com> X-Mailer: git-send-email 2.20.1 MIME-Version: 1.0 X-BeenThere: pacman-contrib@lists.archlinux.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Discussion list for pacman-contrib development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: =?utf-8?q?Johannes_L=C3=B6thberg?= Errors-To: pacman-contrib-bounces@lists.archlinux.org Sender: "pacman-contrib" Signed-off-by: Johannes Löthberg --- doc/Makefile.am | 4 ++++ doc/pacsort.8.txt | 55 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 59 insertions(+) create mode 100644 doc/pacsort.8.txt diff --git a/doc/Makefile.am b/doc/Makefile.am index 8705e71..d5e33ab 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -7,6 +7,7 @@ ASCIIDOC_MANS = \ checkupdates.8 \ paccache.8 \ pacdiff.8 \ + pacsort.8 \ pactree.8 \ updpkgsums.8 @@ -14,6 +15,7 @@ HTML_MANPAGES = \ checkupdates.8.html \ paccache.8.html \ pacdiff.8.html \ + pacsort.8.html \ pactree.8.html \ updpkgsums.8.html @@ -30,6 +32,7 @@ EXTRA_DIST = \ checkupdates.8.txt \ paccache.8.txt \ pacdiff.8.txt \ + pacsort.8.txt \ pactree.8.txt \ updpkgsums.8.txt \ footer.txt \ @@ -110,6 +113,7 @@ checkupdates.8 checkupdates.8.html: checkupdates.8.txt paccache.8 paccache.8.html: paccache.8.txt pacdiff.8 pacdiff.8.html: pacdiff.8.txt pactree.8 pactree.8.html: pactree.8.txt +pacsort.8 pacsort.8.html: pacsort.8.txt updpkgsums.8 updpkgsums.8.html: updpkgsums.8.txt # vim:set noet: diff --git a/doc/pacsort.8.txt b/doc/pacsort.8.txt new file mode 100644 index 0000000..5b0b964 --- /dev/null +++ b/doc/pacsort.8.txt @@ -0,0 +1,55 @@ +///// +vim:set ts=4 sw=4 syntax=asciidoc noet spell spelllang=en_us: +///// +pacsort(8) +========= + +Name +---- +pacsort - sort utility implementing alpm_pkg_vercmp + + +Synopsis +-------- +'pacsort' [options] [files...] + + +Description +----------- +'pacsort' concatenates the given files, sorts them, and writes them to standard +output. Default order is oldest to newest. + +Standard input is read when no files are given. + +By default the lines are treated as lists of plain version strings. + + +Options +------- +*-f, \--files*:: + If the input lists are in the format '\*-*.pkg.tar.?z', sort lines by pkgname and pkgver. + +*-h, \--help*:: + Display syntax and command line options. + +*-k, \--key *:: + Sort the input starting on the specified column. + +*-r, \--reverse*:: + Sort in reverse order. + +*-t, \--separator *:: + Field separator. Default separator is space. + +*-v, \--version*: + Display the version. + +*-z, \--null*:: + Lines end with null bytes rather than newlines. + + +See Also +-------- +linkman:pacman[8], linkman:vercmp[8] + +include::footer.txt[]