[PATCH] proposed documentation changes

Previous message: Greg KH: "Re: [PATCH] skb set_owner_w hook"
Next in thread: Stephen Smalley: "Re: [PATCH] proposed documentation changes"
Reply: Stephen Smalley: "Re: [PATCH] proposed documentation changes"
Reply: Chris Wright: "Re: [PATCH] proposed documentation changes"
Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

gregat_private

Hi all,

With the latest patch from Tim Jansen, adding support for kernel
documentation to structures and other data types [1], I've started to
convert the current comments in security.h over to the new format.

Attached is 4 patches, please let me know if anyone objects to them.

lsm-1.221.patch:
	adds Tim's patch to the tree

lsm-1.222.patch:
	adds security.h to the documentation build process

lsm-1.223.patch:
	adds security.h to the list of files kernel-api.tpl depends on.

lsm-1.224.patch:
	converts the bimprm_security_ops comments to the new format.

Right now it doesn't look like security.h is getting pulled into the
kernel-api.* files properly, so some work needs to be done on that.  But
you can check the output of what the documentation looks like for
security.h by running it through kernel-doc by hand.

I agree we are loosing a bit of information that was previously there in
the comments, and if anyone can suggest a way to fix this, please let me
know.

thanks,

greg k-h

  [1] http://marc.theaimsgroup.com/?l=linux-kernel&m=100146748829448