diff --git a/README.org b/README.org
index cee003d..572386d 100644
--- a/README.org
+++ b/README.org
@@ -30,9 +30,13 @@
   - =:imports= :: Shorthand for supplying imports to the app. This should be
                   used when you're letting the application handle the =main=
                   function. To supply more, use a list.
-  - =:package= :: Set the package of the file. *Requires :main no*. If
-                  not set, and code doesn't have a explicit package, then =main=
-                  package is declared.
+  - =:package= :: Set the package of the file or disable automatic insertion
+                  of the package declaration. Setting custom package name
+                  *requires :main no*. If not set, and code doesn't have an
+                  explicit package, then =main= package is declared. To
+                  prevent adding the package declaration line use '=discard=
+                  value (useful when tangling multiple source blocks to
+                  one file).
   - =:var= :: `ob-go' also supports Babel variables with some limitations. See
               `ob-go' for more information about some of the limitations using
               =:var=.