svn commit: samba r23542 - in branches/SAMBA_4_0: . source/lib/tdr source/script

[jelmer at samba.org]

Author: jelmer
Date: 2007-06-18 21:48:57 +0000 (Mon, 18 Jun 2007)
New Revision: 23542

WebSVN: http://websvn.samba.org/cgi-bin/viewcvs.cgi?view=rev&root=samba&rev=23542

Log:
Include function documentation in prototype headers.
Modified:
   branches/SAMBA_4_0/
   branches/SAMBA_4_0/source/lib/tdr/tdr.c
   branches/SAMBA_4_0/source/script/mkproto.pl


Changeset:

Property changes on: branches/SAMBA_4_0
___________________________________________________________________
Name: bzr:revision-info
   - timestamp: Fri 2007-06-01 13:45:21.213999987 +0200
committer: Jelmer Vernooij <jelmer at samba.org>
properties: 
	branch-nick: SAMBA_4_0

   + timestamp: Mon 2007-06-18 23:45:24.862999916 +0200
committer: Jelmer Vernooij <jelmer at samba.org>
properties: 
	branch-nick: SAMBA_4_0

Name: bzr:revision-id-v3
   - jelmer at samba.org-20070528142122-cf5oh79k3uyecr1j
jelmer at samba.org-20070528210210-rmhpmrglmhpe9aps
jelmer at samba.org-20070601114521-2xayni5somt1iwse

   + jelmer at samba.org-20070528142122-cf5oh79k3uyecr1j
jelmer at samba.org-20070528210210-rmhpmrglmhpe9aps
jelmer at samba.org-20070601114521-2xayni5somt1iwse
12369 jelmer at samba.org-20070618214524-xu3jrkjbp7bwn0yf

Name: bzr:merge
...skipped...

Modified: branches/SAMBA_4_0/source/lib/tdr/tdr.c
===================================================================
--- branches/SAMBA_4_0/source/lib/tdr/tdr.c	2007-06-18 16:10:00 UTC (rev 23541)
+++ branches/SAMBA_4_0/source/lib/tdr/tdr.c	2007-06-18 21:48:57 UTC (rev 23542)
@@ -45,7 +45,7 @@
 #define TDR_SSVAL(tdr, ofs, v) do { if (TDR_BE(tdr))  { RSSVAL(tdr->data.data,ofs,v); } else SSVAL(tdr->data.data,ofs,v); } while (0)
 #define TDR_SIVAL(tdr, ofs, v) do { if (TDR_BE(tdr))  { RSIVAL(tdr->data.data,ofs,v); } else SIVAL(tdr->data.data,ofs,v); } while (0)
 
-/*
+/**
   expand the available space in the buffer to 'size'
 */
 NTSTATUS tdr_push_expand(struct tdr_push *tdr, uint32_t size)
@@ -198,10 +198,11 @@
 	return NT_STATUS_OK;
 }
 
-/*
+/**
   pull a ipv4address
 */
-NTSTATUS tdr_pull_ipv4address(struct tdr_pull *tdr, TALLOC_CTX *ctx, const char **address)
+NTSTATUS tdr_pull_ipv4address(struct tdr_pull *tdr, TALLOC_CTX *ctx, 
+							  const char **address)
 {
 	struct ipv4_addr in;
 	TDR_CHECK(tdr_pull_uint32(tdr, ctx, &in.addr));
@@ -211,7 +212,7 @@
 	return NT_STATUS_OK;
 }
 
-/*
+/**
   push a ipv4address
 */
 NTSTATUS tdr_push_ipv4address(struct tdr_push *tdr, const char **address)
@@ -221,7 +222,7 @@
 	return NT_STATUS_OK;
 }
 
-/*
+/**
   print a ipv4address
 */
 NTSTATUS tdr_print_ipv4address(struct tdr_print *tdr, const char *name, 
@@ -231,7 +232,7 @@
 	return NT_STATUS_OK;
 }
 
-/*
+/**
   parse a hyper
 */
 NTSTATUS tdr_pull_hyper(struct tdr_pull *tdr, TALLOC_CTX *ctx, uint64_t *v)
@@ -243,7 +244,7 @@
 	return NT_STATUS_OK;
 }
 
-/*
+/**
   push a hyper
 */
 NTSTATUS tdr_push_hyper(struct tdr_push *tdr, uint64_t *v)
@@ -255,9 +256,7 @@
 	return NT_STATUS_OK;
 }
 
-
-
-/*
+/**
   push a NTTIME
 */
 NTSTATUS tdr_push_NTTIME(struct tdr_push *tdr, NTTIME *t)
@@ -266,7 +265,7 @@
 	return NT_STATUS_OK;
 }
 
-/*
+/**
   pull a NTTIME
 */
 NTSTATUS tdr_pull_NTTIME(struct tdr_pull *tdr, TALLOC_CTX *ctx, NTTIME *t)
@@ -275,7 +274,7 @@
 	return NT_STATUS_OK;
 }
 
-/*
+/**
   push a time_t
 */
 NTSTATUS tdr_push_time_t(struct tdr_push *tdr, time_t *t)
@@ -283,7 +282,7 @@
 	return tdr_push_uint32(tdr, (uint32_t *)t);
 }
 
-/*
+/**
   pull a time_t
 */
 NTSTATUS tdr_pull_time_t(struct tdr_pull *tdr, TALLOC_CTX *ctx, time_t *t)

Modified: branches/SAMBA_4_0/source/script/mkproto.pl
===================================================================
--- branches/SAMBA_4_0/source/script/mkproto.pl	2007-06-18 16:10:00 UTC (rev 23541)
+++ branches/SAMBA_4_0/source/script/mkproto.pl	2007-06-18 21:48:57 UTC (rev 23542)
@@ -158,10 +158,24 @@
 
 	$private_file->("\n/* The following definitions come from $filename  */\n\n");
 
+	my $comment = undef;
+	my $incomment = 0;
 	while (my $line = <FH>) {	      
 		my $target = \&private;
 		my $is_public = 0;
 
+		if ($line =~ /^\/\*\*/) { 
+			$comment = "";
+			$incomment = 1;
+		}
+
+		if ($incomment) {
+			$comment .= $line;
+			if ($line =~ /\*\//) {
+				$incomment = 0;
+			}
+		} 
+
 		# these are ordered for maximum speed
 		next if ($line =~ /^\s/);
 	      
@@ -189,6 +203,8 @@
 
 		next if ($line =~ /^int\s*main/);
 
+		$target->("\n$comment") if (defined($comment)); $comment = undef;
+
 		if ( $line =~ /\(.*\)\s*$/o ) {
 			chomp $line;
 			$target->("$line;\n");