From 44a3ec4c9ad554e6fac4fef13ee7f25ddacc9470 Mon Sep 17 00:00:00 2001
From: Costa Shulyupin <constantine.shulyupin@gmail.com>
Date: Tue, 4 Oct 2022 18:51:25 +0300
Subject: [PATCH] textspan: doxygen comments

---
 lib/common/textspan.c     | 6 ++++++
 lib/common/textspan.h     | 5 +++++
 lib/common/textspan_lut.h | 5 +++++
 3 files changed, 16 insertions(+)

diff --git a/lib/common/textspan.c b/lib/common/textspan.c
index dc54287c2..fe48f9b84 100644
--- 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 394b5b043..4fa0651ed 100644
--- 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 38ab1bd6d..7719e33e2 100644
--- 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>
-- 
2.40.0