[Bug 278458] ng_bridge(4) states that uplinkX is valid, but fails if uplink0 is given

2024-04-19 Thread bugzilla-noreply
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=278458

Bug ID: 278458
   Summary: ng_bridge(4) states that uplinkX is valid, but fails
if uplink0 is given
   Product: Documentation
   Version: Latest
  Hardware: Any
OS: Any
Status: New
  Severity: Affects Only Me
  Priority: ---
 Component: Manual Pages
  Assignee: b...@freebsd.org
  Reporter: parakl...@darkreality.org
CC: d...@freebsd.org

Most examples show ng_bridge being connected to ng_ether with :lower being
connected to :link0 (see /usr/share/examples/netgraph/virtual.lan among
others).

The ng_bridge man page suggests that it is desirable to connect the :lower hook
of ng_ether to an uplink hook of the form :uplinkX.

Unfortunately, when combining these two instructions we get an illegal
arrangement which responds with `ngctl: send msg: Invalid argument` and no
further explanation.

I had to read through the code changes in https://reviews.freebsd.org/D23963 to
see that the uplink form was disallowed when the link number is 0 (see
`sys/netgraph/ng_bridge.c:360` in that commit).

It is not clear to me from that change request why 0 was disallowed, and this
seems contrary to the common guidance on how to connect ng_bridge to ng_ether,
so either this restriction should be removed or the man page should be updated
to be explicit that this is disallowed (and perhaps provide an example scenario
which could be copied).

-- 
You are receiving this mail because:
You are on the CC list for the bug.


[Bug 274897] expand(1) man page contains spurious characters

2024-04-19 Thread bugzilla-noreply
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=274897

--- Comment #1 from commit-h...@freebsd.org ---
A commit in branch main references this bug:

URL:
https://cgit.FreeBSD.org/src/commit/?id=8993d785a261ee92528b44dae5a629ce389de412

commit 8993d785a261ee92528b44dae5a629ce389de412
Author: Gordon Bergling 
AuthorDate: 2024-04-19 15:39:37 +
Commit: Gordon Bergling 
CommitDate: 2024-04-19 15:39:37 +

expand.1: Fix markup for the '-t' option

When viewing the manpage the '-t' option is shown as follows

-t -Sm tab1, tab2, ..., tabn Sm

with the markup '\&Sm' included within '.It Fl t', which doesn't
makes any sense.

So just remove it.

PR: 274897
MFC after:  3 days

 usr.bin/expand/expand.1 | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

-- 
You are receiving this mail because:
You are on the CC list for the bug.


[Bug 274897] expand(1) man page contains spurious characters

2024-04-19 Thread bugzilla-noreply
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=274897

Gordon Bergling  changed:

   What|Removed |Added

 Status|Open|In Progress

-- 
You are receiving this mail because:
You are on the CC list for the bug.