diff --git a/collects/texpict/doc.txt b/collects/texpict/doc.txt
index 04dbb8638e..c927915107 100644
--- a/collects/texpict/doc.txt
+++ b/collects/texpict/doc.txt
@@ -1044,10 +1044,13 @@ The _code-params^_ signature contains two elements:
 
 The _code^_ unit supplies the following
 
-> (typeset-code stx) - produces a pict for code in the given syntax
-  object. The source-location information of the syntax object
-  determines the line breaks, line indenting, and space within a row.
-  Empty rows are ignored.
+> (typeset-code stx) - produces a pict for code in the given
+  syntax object. The source-location information of the
+  syntax object determines the line breaks, line indenting,
+  and space within a row.  Empty rows are ignored. (Beware
+  that if you use read-syntax on a file port, you may have
+  to turn on line counting via port-count-lines! for the
+  code to typeset properly.)
 
   Normally, `typeset-code' is used through a macro (often called
   `code') that is generated by `define-code'. See below for more