kernel-doc: restrict syntax for private: and public:

Inside a struct description, you can use the "private:" and "public:"

comment tags.  Structure fields that are inside a "private:" area

are not listed in the generated output documentation.

are not listed in the generated output documentation.  The "private:"

and "public:" tags must begin immediately following a "/*" comment

marker.  They may optionally include comments between the ":" and the

ending "*/" marker.

Example:

struct my_struct {

    int a;

    int b;

/* private: */

/* private: internal use only */

    int c;

};

    my $nested;

    if ($x =~ /(struct|union)\s+(\w+)\s*{(.*)}/) {

	#my $decl_type = $1;

	$declaration_name = $2;

	my $members = $3;

	$nested = $1;

	# ignore members marked private:

	$members =~ s/\/\*.*?private:.*?public:.*?\*\///gos;

	$members =~ s/\/\*.*?private:.*//gos;

	$members =~ s/\/\*\s*private:.*?\/\*\s*public:.*?\*\///gos;

	$members =~ s/\/\*\s*private:.*//gos;

	# strip comments:

	$members =~ s/\/\*.*?\*\///gos;

	$nested =~ s/\/\*.*?\*\///gos;