All required corerctions as:
authorJoey Schulze <joey@infodrom.org>
Sat, 27 Nov 2004 09:26:31 +0000 (09:26 +0000)
committerJoey Schulze <joey@infodrom.org>
Sat, 27 Nov 2004 09:26:31 +0000 (09:26 +0000)
 - translation/wording
 - \f* -> .BR/.I
 - removed newlines
 - proper section translations
 - trailing fullstop

man3/asprintf.3

index d99b356..bfd1785 100644 (file)
@@ -26,8 +26,8 @@
 .\"
 .TH ASPRINTF 3 2004-11-25 "GNU" "Bibliotheksfunktionen"
 .SH NAME
-asprintf, vasprintf \- formatierte Ausgabe in zugeteilte Zeichenketten
-.SH UEBERSICHT
+asprintf, vasprintf \- Ausgabe in allokierte Zeichenkette
+.SH "ÜBERSICHT"
 .B #define _GNU_SOURCE
 .br
 .B #include <stdio.h>
@@ -36,26 +36,39 @@ asprintf, vasprintf \- formatierte Ausgabe in zugeteilte Zeichenketten
 .sp
 .BI "int vasprintf(char **" strp ", const char *" fmt ", va_list " ap );
 .SH BESCHREIBUNG
-Die Funktionen \fBasprintf\fR und \fBvasprintf\fR sind analog zu
-\fBsprintf\fR und \fBvsprintf\fR, ausgenommen das sie eine
-Zeichenkette zuteilen die lang genug ist, die Ausgabe zu enthalten
-inklusive der terminierenden NUL.  Der ersten Parameter wird benutzt
-auf den zugewiesenen Speicher zu zeigen.  Der  Speicher kann mit
-\fBfree\fR(3) wieder freigegeben werden.
-.SH RUECKGABEWERT
-Wenn erfolgreich, geben diese Funktionen die Anzahl von Bytes zurueck,
-wie bei \fBsprintf\fR(3).  Wenn die Speicherzuteilung nicht moeglich,
-oder andere Fehler auftreten, geben diese Funktionen -1 zurueck und
-der Inhalt von \fIstrp\fR ist undefiniert.
-
-.SH ANMERKUNG
+Die Funktionen
+.B asprintf
+und
+.B vasprintf
+sind analog zu
+.B sprintf
+und
+.B vsprintf
+mit der Ausnahme, daß sie Speicherplatz für die Zeichenkette
+allokieren, der ausreichend groß ist, um die Ausgabe inklusive des
+abschließenden NUL-Zeichens aufzunehmen.  Ein Zeiger darauf wird über
+den ersten Parameter zurückgegeben.  Dieser Zeiger sollte an
+.BR free (3)
+übergeben werden, um den belegten Speicherbereich wieder freizugeben,
+wenn er nicht mehr benötigt wird.
+.SH "RÜCKGABEWERT"
+Wenn erfolgreich, geben diese Funktionen die Anzahl von ausgegebenen
+Bytes zurück, wie bei
+.BR sprintf (3).
+Wenn die Speicherzuteilung nicht möglich war,
+oder andere Fehler auftreten, geben diese Funktionen -1 zurück und
+der Inhalt von
+.I strp
+ist undefiniert.
+.SH ANMERKUNGEN
 Diese Funktionen sind GNU Erweiterungen, und nicht in C oder POSIX
-definiert.  Sie sind ebenso verfuegbar unter *BSD.  Die FreeBSD
-Implementation setzt \fIstrp\fR bei Fehler auf NULL.
-.SH SIEHE AUCH
-
+definiert.  Sie sind ebenso verfügbar unter *BSD.  Die FreeBSD
+Implementation setzt
+.I strp
+bei Fehler auf NULL.
+.SH "SIEHE AUCH"
 .BR  free (3),
 .BR  malloc (3),
-.BR  printf (3)
+.BR  printf (3).