diff --git a/reference/pdf/functions/pdf-arc.xml b/reference/pdf/functions/pdf-arc.xml
index 01f6d44441..fecff9641f 100644
--- a/reference/pdf/functions/pdf-arc.xml
+++ b/reference/pdf/functions/pdf-arc.xml
@@ -1,5 +1,5 @@
-
+
@@ -17,16 +17,51 @@
floatalpha
floatbeta
-
- Draw a counterclockwise circular arc with center (x,
- y) and radius r from
- alpha to beta degrees.
- &return.success;
-
-
- See also pdf_arcn and
- pdf_circle.
-
+
+ Add a counterclockwise circular arc from
+ alpha to beta degrees
+ with center (x; y)
+ and radius r. Actual drawing of the circle is performed by
+ the next stroke or fill operation.
+
+
+ See also: pdf_arcn,
+ pdf_circle, pdf_stroke,
+ pdf_fill and pdf_fill_stroke.
+
+
+ pdf_arcn example
+
+
+]]>
+
+
diff --git a/reference/pdf/functions/pdf-arcn.xml b/reference/pdf/functions/pdf-arcn.xml
index c615f0f1ac..48a645e96c 100644
--- a/reference/pdf/functions/pdf-arcn.xml
+++ b/reference/pdf/functions/pdf-arcn.xml
@@ -1,5 +1,5 @@
-
+
@@ -17,16 +17,51 @@
floatalpha
floatbeta
-
- Draw a clockwise circular arc with center (x,
- y) and radius r from
- alpha to beta degrees.
- &return.success;
-
-
- See also pdf_arc and
- pdf_circle.
-
+
+ Add a clockwise circular arc from
+ alpha to beta degrees
+ with center (x; y)
+ and radius r. Actual drawing of the circle is performed by
+ the next stroke or fill operation.
+
+
+ See also: pdf_arc, pdf_circle,
+ pdf_stroke, pdf_fill and
+ pdf_fillstroke.
+
+
+ pdf_arcn example
+
+
+]]>
+
+
diff --git a/reference/pdf/functions/pdf-circle.xml b/reference/pdf/functions/pdf-circle.xml
index 2f26ffb6c8..3a543170cb 100644
--- a/reference/pdf/functions/pdf-circle.xml
+++ b/reference/pdf/functions/pdf-circle.xml
@@ -1,5 +1,5 @@
-
+
@@ -16,12 +16,52 @@
floatr
- Draw a circle with center (x, y)
- and radius r. &return.success;
+ Add a circle with center (x,
+ y) and radius r
+ to the current page. Actual drawing of the circle is performed by
+ the next stroke or fill operation.
- See also pdf_arc and
- pdf_arcn.
+ &return.success;
+
+
+ pdf_circle example
+
+
+]]>
+
+
+
+ See also: pdf_arc,
+ pdf_arcn, pdf_curveto,
+ pdf_stroke, pdf_fill and
+ pdf_fill_stroke.