From owner-dev-commits-src-all@freebsd.org Thu Mar 4 13:56:27 2021 Return-Path: Delivered-To: dev-commits-src-all@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 9FF6454A8AD; Thu, 4 Mar 2021 13:56:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Drspz46Y9z3nSJ; Thu, 4 Mar 2021 13:56:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 802BF1E51F; Thu, 4 Mar 2021 13:56:27 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 124DuRXS052191; Thu, 4 Mar 2021 13:56:27 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 124DuRli052190; Thu, 4 Mar 2021 13:56:27 GMT (envelope-from git) Date: Thu, 4 Mar 2021 13:56:27 GMT Message-Id: <202103041356.124DuRli052190@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Fernando Apesteguía Subject: git: fc1e79740e4a - main - compress(1): warn about link handling MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: fernape X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: fc1e79740e4a83013aa0050fc95a991ec9c78e27 Auto-Submitted: auto-generated X-BeenThere: dev-commits-src-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the src repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 04 Mar 2021 13:56:27 -0000 The branch main has been updated by fernape (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=fc1e79740e4a83013aa0050fc95a991ec9c78e27 commit fc1e79740e4a83013aa0050fc95a991ec9c78e27 Author: Fernando Apesteguía AuthorDate: 2021-02-09 09:11:22 +0000 Commit: Fernando Apesteguía CommitDate: 2021-03-04 13:52:12 +0000 compress(1): warn about link handling compress(1) handles links badly and does not provide link-handling options. Document this behavior. PR: 84271 Submitted by: garys@opusnet.com Approved by: gbe@ (mentor) Differential Revision: https://reviews.freebsd.org/D28552 --- usr.bin/compress/compress.1 | 11 ++++++++++- 1 file changed, 10 insertions(+), 1 deletion(-) diff --git a/usr.bin/compress/compress.1 b/usr.bin/compress/compress.1 index de44653775ea..3aa18a963cdc 100644 --- a/usr.bin/compress/compress.1 +++ b/usr.bin/compress/compress.1 @@ -32,7 +32,7 @@ .\" @(#)compress.1 8.2 (Berkeley) 4/18/94 .\" $FreeBSD$ .\" -.Dd October 20, 2020 +.Dd March 4, 2021 .Dt COMPRESS 1 .Os .Sh NAME @@ -177,6 +177,13 @@ Compression is generally much better than that achieved by Huffman coding (as used in the historical command pack), or adaptive Huffman coding (as used in the historical command compact), and takes less time to compute. +.Pp +If +.Ar file +is a soft or hard link +.Nm +will replace it with a compressed copy of the file pointed to by the link. +The link's target file is left uncompressed. .Sh EXIT STATUS .Ex -std compress uncompress .Pp @@ -248,6 +255,8 @@ The command appeared in .Bx 4.3 . .Sh BUGS +The program does not handle links well and has no link-handling options. +.Pp Some of these might be considered otherwise-undocumented features. .Pp .Nm compress :