From owner-freebsd-doc@freebsd.org Sat Aug 18 10:44:48 2018 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 1989D108C6CB for ; Sat, 18 Aug 2018 10:44:48 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: from mail-wr1-f46.google.com (mail-wr1-f46.google.com [209.85.221.46]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (Client CN "smtp.gmail.com", Issuer "Google Internet Authority G3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 8328B8D1DA for ; Sat, 18 Aug 2018 10:44:47 +0000 (UTC) (envelope-from mpp302@gmail.com) Received: by mail-wr1-f46.google.com with SMTP id m27-v6so2859000wrf.3 for ; Sat, 18 Aug 2018 03:44:47 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:from:to:subject:message-id:mime-version :content-transfer-encoding; bh=a5B5hpvY7/plS1EsfMco3JO1ZHyzKNdLwk8uyl4o95o=; b=blp43X8XRZ7pA3tvsItcO6/1HBhDn3DcAwU9NybfCXVihheV+vTIiJ23a44J5HopFW n0MTafF5LWExnUWAUmI0+9yOcejfKLBx1I2XLWSqDMofrNYjiYmfdiEerC+Un1Sz7yaj 1VPR5FqX1vVhmF994TF4pl0yfJ4g0ND45Sjc9umo6+uGLwkr6A8j2VhXexi27AOdss3h er24Eg4+G81fEoOf5MUxTeUoDIScKPkZtFpeDy/Oz3Su9tZhKI1cEoUUSR0Plky6jQ87 19nNo9ituNf99T2NKN/A5rohYi3bJR+iNbiHk5qmlBztz0bOhbNPKycuJLln48opg4kH bb9Q== X-Gm-Message-State: AOUpUlFdhuNtHrU/dY8KpKWRBZHFUIogUEZ6Gb+TFWkwFCk4uVMt57sL zJlLZDqkiPy13svZSlD40Jp+ReGd X-Google-Smtp-Source: AA+uWPztYFC1ruj6VXO5xgN+6TA/pmWvl0+SlNFnxIabNkvo4uBgkD15CoUja4u5eFdyR+zrKkrSDQ== X-Received: by 2002:adf:f906:: with SMTP id b6-v6mr21135956wrr.28.1534589086270; Sat, 18 Aug 2018 03:44:46 -0700 (PDT) Received: from e5500 (global-5-184.nat-2.net.cam.ac.uk. [131.111.5.184]) by smtp.gmail.com with ESMTPSA id o33-v6sm10874784wrf.11.2018.08.18.03.44.45 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sat, 18 Aug 2018 03:44:46 -0700 (PDT) Date: Sat, 18 Aug 2018 11:44:42 +0100 From: Mateusz Piotrowski <0mp@FreeBSD.org> To: freebsd-doc@freebsd.org Subject: Replacing svn(1) with svnlite(1) in manpages and documentation Message-ID: <20180818114442.36e7ec9b@e5500> X-Mailer: Claws Mail 3.16.0 (GTK+ 2.24.32; i386-portbld-freebsd11.1) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.27 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 18 Aug 2018 10:44:48 -0000 Hello, It looks like some users find it confusing that the documentation speaks of using svn although it is not present in the base system.[1] I can think of two solutions to this problem: 1. Link /usr/bin/svn to /usr/bin/svnlite and use svn consistently throughout documentation. This solution might turn out to be confusing whenever svn from ports is installed and /usr/bin is earlier in PATH than /usr/local/bin. 2. Use svnlite consistently throughout documentation. Some manpages like development(7) have already switched to using svnlite in their examples. Personally, I'd go for the second solution. Can you think of any potential problems we might face? Regards, Mateusz Piotrowski [1]: https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=222692