From 0dff6919f3ed4bc2b15bb6ebbe97e1f8038bea4e Mon Sep 17 00:00:00 2001
From: Costa Shulyupin <constantine.shulyupin@gmail.com>
Date: Sat, 28 May 2022 07:11:52 +0300
Subject: [PATCH] partition.h: add doxygen comments

---
 lib/ortho/partition.h | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/lib/ortho/partition.h b/lib/ortho/partition.h
index 35a15c7a2..58960b3cc 100644
--- a/lib/ortho/partition.h
+++ b/lib/ortho/partition.h
@@ -1,3 +1,8 @@
+/**
+ * @file
+ * @brief function @ref partition, subroutine of @ref mkMaze
+ */
+
 /*************************************************************************
  * Copyright (c) 2011 AT&T Intellectual Property 
  * All rights reserved. This program and the accompanying materials
@@ -12,4 +17,12 @@
 
 #include <ortho/maze.h>
 
+/**
+ * @brief partitions space around cells (nodes) into rectangular tiles
+ * @param[in] cells rectangular borders of user's input graph's nodes
+ * @param[in] bb range of the space to partition
+ * @param[out] nrects number of tiles
+ * @returns array of the tiles
+ */
+
 boxf* partition(cell* cells, int ncells, int* nrects, boxf bb);
-- 
2.40.0