From owner-dev-commits-doc-all@freebsd.org Sat Feb 27 22:59:43 2021 Return-Path: Delivered-To: dev-commits-doc-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 82D1F557351 for ; Sat, 27 Feb 2021 22:59:43 +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 4Dp2673Mj1z4W3m; Sat, 27 Feb 2021 22:59:43 +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 667A525F01; Sat, 27 Feb 2021 22:59:43 +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 11RMxh20040322; Sat, 27 Feb 2021 22:59:43 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 11RMxhTi040321; Sat, 27 Feb 2021 22:59:43 GMT (envelope-from git) Date: Sat, 27 Feb 2021 22:59:43 GMT Message-Id: <202102272259.11RMxhTi040321@gitrepo.freebsd.org> To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Stefan Eßer Subject: git: e6c3288d6b - main - Modify entries for bc(1), calendar(1), and getlocalbase(3) MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: se X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: e6c3288d6be73759e6149c1798a5eafdd69bf208 Auto-Submitted: auto-generated X-BeenThere: dev-commits-doc-all@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commit messages for all branches of the doc repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 27 Feb 2021 22:59:43 -0000 The branch main has been updated by se (ports, src committer): URL: https://cgit.FreeBSD.org/doc/commit/?id=e6c3288d6be73759e6149c1798a5eafdd69bf208 commit e6c3288d6be73759e6149c1798a5eafdd69bf208 Author: Stefan Eßer AuthorDate: 2021-02-27 22:58:07 +0000 Commit: Stefan Eßer CommitDate: 2021-02-27 22:58:07 +0000 Modify entries for bc(1), calendar(1), and getlocalbase(3) Match the style of the other entries in this document. --- website/content/en/releases/13.0R/relnotes.adoc | 51 +++++++------------------ 1 file changed, 14 insertions(+), 37 deletions(-) diff --git a/website/content/en/releases/13.0R/relnotes.adoc b/website/content/en/releases/13.0R/relnotes.adoc index 3e235f6bd2..fc9f40d388 100644 --- a/website/content/en/releases/13.0R/relnotes.adoc +++ b/website/content/en/releases/13.0R/relnotes.adoc @@ -103,6 +103,15 @@ This section covers changes and additions to userland applications, contributed [[userland-programs]] === Userland Application Changes +The {{< manpage "calendar" "1" >}} utility got back support for nested C pre-processor conditionals and gains support for the C++ comment syntax in addition to the C syntax. gitref:19b5c307548[repository=src] + +The {{< manpage "calendar" "1" >}} utility has been modified to consistently print dates according to the locale of the invoking user, not the possibly varying locales of included files. gitref:f1560bd080a[repository=src] + +The {{< manpage "calendar" "1" >}} utility has been fixed to use the correct paths for included files if invoked with the -a option. gitref:19b5c307548[repository=src] + +The {{< manpage "calendar" "1" >}} utility does no longer install data files other than calendar.freebsd. +The data files are now provided by the deskutils/calendar-data port. gitref:d20d6550187[repository=src] + The {{< manpage "daemon" "8" >}} utility now supports the `-H` flag, which causes it to catch SIGHUP and re-open the syslog file received, so log rotation from {{< manpage "newsyslog" "8">}} works properly. gitref:4cd407ec933[repository=src] The {{< manpage "daemon" "8" >}} utility no longer blocks SIGTERM during the restart delay. gitref:09a3675d961[repository=src] @@ -123,38 +132,13 @@ The manual page for the {{< manpage "inetd" "8" >}} utility now includes an exam The {{< manpage "inetd" "8" >}} utility now includes comments for all examples. gitref:26a4a61a285[repository=src] -==== calendar: Restore calendar file condition parsing - -The calendar program used to invoke the traditional C pre-processor to process include files and conditional sections of the data files. -This had to be changed when the traditional C pre-processor was removed from FreeBSD, and a simple pre-processor was implemented within the calendar program itself. - -The calendar program in FreeBSD-13 restores the condition and comment processing to the level provided by the C pre-processor and offers the following features: - -- Support `#undef` to cancel a prior `#define` -- `#ifdef`, `#ifndef`, `#else`, and `#endif` are supported and can be nested -- `#include` is now processed using the calendar owner's home directory (not the invoking user's home directory, fixes `calendar -a`) -- Support for C and C++ style comments - -Dates are now always displayed according to the locale of the invoking user, not the (optional) locales specified in the calendar files. -This prevents printing mixed date formats depending on the locales specified in each of the data files. - -The calendar data files that used to be distributed with earlier version of FreeBSD have been moved to the package:deskutils/calendar-data[] port respectively the calendar-data package, with the exception of the FreeBSD committer data file, which has been kept. - [[userland-contrib]] === Contributed Software -==== contrib/bc: New implementation of the bc and dc programs - -This implementation of the `bc` and `dc` programs offers a number of advantages over the previous versions in the FreeBSD base system: - -- They do not depend on external large number functions (i.e. no dependency on OpenSSL or any other large number library). -- They implements all features found in GNU bc/dc (with the exception of the forking of sub-processes, which the author of this version considers as a security issue). -- They are significantly faster than the current code in base (more than 2 orders of magnitude in some of my tests, e.g. for 12345^100000). -- They should be fully compatible with all features and the behavior of the current implementations in FreeBSD. -- They support POSIX message catalogs and come with localized messages in Chinese, Dutch, English, French, German, Japanese, Polish, Portugueze, and Russian. -- They offer very detailed manual pages that provide far more information than the current ones. - -The previous implementation is still available in FreeBSD-13 and can be selected instead of the new one by the build option `WITHOUT_GH_BC`. +The {{< manpage "bc" "1" >}} and {{< manpage "dc" "1" >}} utilities have been replaced by the version developed by Gavin D. Howard. +The new versions do not depend on an external large number library, offer GNU bc extensions, are much faster than and fix POSIX compliance issues of the programs they replace. +They support POSIX message catalogs and come with localized messages in Chinese, Dutch, English, French, German, Japanese, Polish, Portugueze, and Russian. +The previous implementation is still available in FreeBSD-13 and can be selected instead of the new one by the build option `WITHOUT_GH_BC`. gitref:c41fef90a7d[repository=src] [[userland-deprecated-programs]] === Deprecated Applications @@ -163,14 +147,7 @@ The previous implementation is still available in FreeBSD-13 and can be selected [[userland-libraries]] === Runtime Libraries and API -==== getlocalbase() function - -A function has been added to libutil to provide applications with a standard way to determine the path prefix for files installed by ports and packages. - -This function will return the value of the environment variable `LOCALBASE` if it has been defined. -Else the value of the {{< manpage "sysctl" "8" >}} variable `user.localbase` is returned, which has a default value of `__PATH_LOCALBASE` ([.filename]#/usr/local#, unless changed in [.filename]#paths.h#). - -Shell scripts can directly use the environment variable `LOCALBASE` or `sysctl user.localbase` for this purpose. +The {{< manpage "getlocalbase" "3" >}} function has been added to libutil to retrieve the LOCALBASE path in a standard way. gitref:30d21d27953[repository=src] [[kernel]] == Kernel