From 5765879aba8dc43c7129347b31e9159c742e1777 Mon Sep 17 00:00:00 2001
From: "Alex A. Naanou" <alex.nanou@gmail.com>
Date: Mon, 27 Feb 2023 17:27:55 +0300
Subject: [PATCH] more notes...

Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
---
 README.md | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index f2aff1b..bb13799 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,5 @@
-# photobook
+photobook
+=========
 
 [LaTeX](https://www.latex-project.org/) document class for making photo books.
 
@@ -43,6 +44,16 @@ For more info on `make` targets see the: [./Makefile](./Makefile)
 
 ## Notes
 
+- There is a bug in default captions not being typeset correctly if too 
+  long, a workaround is to place them in a `minipage` like this:
+  ```latex
+  \imagecell{%
+      \begin{minipage}{\cellwidth}%
+          long caption text...
+      \end{minipage}%
+  }{some-image}
+  ```
+  (still working on a solution for this).
 - `photobook` is mostly used with `lualatex`, other engines are mostly 
   supported but some features may misbehave.