textspan: doxygen comments

diff --git a/lib/common/textspan.c b/lib/common/textspan.c
index dc54287c2bf8e15a3d7528f3a2bd74fe3140c189..fe48f9b845dc77bba86f800abe3e927dd2fdbe35 100644 (file)
--- a/lib/common/textspan.c
+++ b/lib/common/textspan.c
@@ -1,3 +1,8 @@
+/**
+ * @file
+ * @brief @ref textspan_size
+ */
+
 /*************************************************************************
  * Copyright (c) 2011 AT&T Intellectual Property 
  * All rights reserved. This program and the accompanying materials
@@ -70,6 +75,7 @@ static PostscriptAlias* translate_postscript_fontname(char* fontname)
 }
 
 pointf textspan_size(GVC_t *gvc, textspan_t * span)
+/// Estimates size of a textspan, in points.
 {
     char **fpp = NULL, *fontpath = NULL;
     textfont_t *font;

diff --git a/lib/common/textspan.h b/lib/common/textspan.h
index 394b5b0437d530905fbcf3c53f05a2383671aa91..4fa0651ed2ccc434df04329fdb53bb86bc6e2ac1 100644 (file)
--- a/lib/common/textspan.h
+++ b/lib/common/textspan.h
@@ -1,3 +1,8 @@
+/**
+ * @file
+ * @brief @ref textspan_t, @ref textfont_t, @ref PostscriptAlias
+ */
+
 /*************************************************************************
  * Copyright (c) 2011 AT&T Intellectual Property 
  * All rights reserved. This program and the accompanying materials

diff --git a/lib/common/textspan_lut.h b/lib/common/textspan_lut.h
index 38ab1bd6dc5dc55be7f40df991abf4a759955143..7719e33e2ba2760354c286f0585b26013b53b839 100644 (file)
--- a/lib/common/textspan_lut.h
+++ b/lib/common/textspan_lut.h
@@ -1,3 +1,8 @@
+/**
+ * @file
+ * @brief lookup table for textspan
+ */
+
 #pragma once
 
 #include <stdbool.h>