Re: [PATCH v3] Many pages: Document fixed-width types with ISO C naming

On Wed, Aug 24, 2022 at 12:04 PM Alejandro Colomar wrote: > > diff --git a/man2/bpf.2 b/man2/bpf.2 > index d05b73ec2..84d1b62e5 100644 > --- a/man2/bpf.2 > +++ b/man2/bpf.2 > @@ -169,34 +169,34 @@ commands: > .EX > union bpf_attr { > struct {/* Used by BPF_MAP_CREATE */ > -__u32

Re: [RFC v2] bpf.2: Use standard types and attributes

On Tue, May 4, 2021 at 1:33 PM Zack Weinberg wrote: > the information that should > appear in the manpages is the information that is most relevant to > user space programmers. The bpf programs are compiled for the kernel and run in the kernel. Hence bpf man pages must reflect the kernel. Also th

Re: [RFC v2] bpf.2: Use standard types and attributes

On Tue, May 4, 2021 at 4:05 AM Alejandro Colomar wrote: > > Some manual pages are already using C99 syntax for integral > types 'uint32_t', but some aren't. There are some using kernel > syntax '__u32'. Fix those. > > Some pages also document attributes, using GNU syntax > '__attribute__((xxx))'

Re: [RFC] bpf.2: Use standard types and attributes

On Sat, Apr 24, 2021 at 10:56 AM Alejandro Colomar (man-pages) wrote: > > Hello Alexei, > > On 4/24/21 1:20 AM, Alexei Starovoitov wrote: > > Nack. > > The man page should describe the kernel api the way it is in .h file. > > Why? Because man page must describe the linux uapi headers the way they

Re: [RFC] bpf.2: Use standard types and attributes

On Fri, Apr 23, 2021 at 4:15 PM Alejandro Colomar wrote: > > Some manual pages are already using C99 syntax for integral > types 'uint32_t', but some aren't. There are some using kernel > syntax '__u32'. Fix those. > > Some pages also document attributes, using GNU syntax > '__attribute__((xxx))