darevay Dave Ray
seesaw.core is 3500 lines of which probably 2500 are docstrings. I wonder if they could be externalized somehow... #clojure

December 18, 2011     1 retweets #

cemerick Chas Emerick
@darevay Put your docs in another file you load at the *end* of seesaw.core, w/ a bunch of `(alter-meta! #'f assoc :doc "docs")` exprs

December 18, 2011 #

IORayne Anthony Grimes
@cemerick @darevay I hate both of your guts for even thinking about doing this.

December 18, 2011 #

cemerick Chas Emerick
@IORayne bwah? (Er, mission accomplished? :-P)

December 18, 2011 #

darevay Dave Ray
@IORayne @cemerick is this some kind of reverse psych or actual gut hating. Either's fine with me ;)

December 18, 2011 #

darevay Dave Ray
@IORayne @cemerick Chas, sounds like we should come up with a name and set up a repo ASAP. I'm writing the ML announcement now. :)

December 18, 2011 #

cemerick Chas Emerick
@darevay Oh! @IORayne is miffed b/c Marginalia doesn't load namespaces it's generating docs for. What was the rationale for that? /cc @fogus

December 18, 2011 #

fogus fogus
@cemerick patches welcomed.

December 18, 2011 #

cemerick Chas Emerick
@fogus Heh, sure. I'm just wondering if avoiding loading was intentional, i.e. in case someone has a (launch-missiles) top-level.

December 18, 2011 #

cemerick Chas Emerick
@darevay Maybe using: (defmacro docs-for [varname docstring] `(alter-meta! (var ~varname) assoc :doc ~docstring)) ;; :-) #Clojure

December 18, 2011 #

darevay Dave Ray
@cemerick I like it. I was thinking a map of docs in a resource file then a macro that reads it and alters meta...

December 18, 2011 #

cemerick Chas Emerick
@darevay Yup, that'll work.

December 18, 2011 #

darevay Dave Ray
@cemerick ... so (load-docs) loads "resources/*ns*.docs" or something and does alter-meta! for all key/value pairs in the file ...

December 18, 2011 #

darevay Dave Ray
@cemerick ... and if the resource file is missing, it does nothing so you could ship a minified jar if that's important. need more time. :)

December 18, 2011 #

cemerick Chas Emerick
@darevay IMO, I'd wait for (or write!) a proper generalized Clojure minifier/tree-shaker instead of inventing local minification options.

December 18, 2011 #

darevay Dave Ray
@cemerick I'm actually more interested in reducing the file size for *editing* at the mo'. Or maybe I should optimize vimclojure :)

December 18, 2011 #

kotarak Meikel Brandmeyer
@darevay You could try folding. To fold away docstrings. But don't ask me how that works. It always gets in my way, so I turned it off.

December 18, 2011 #

darevay Dave Ray
@kotarak yeah. Folding is something that always seemed more complicated than it was worth.

December 18, 2011 #

darevay Dave Ray
@cemerick ... or maybe I should just stop documenting stuff :)

December 18, 2011 #

kotarak Meikel Brandmeyer
@darevay This is also a wide spread approach. :] I'm a master of it myself.

December 18, 2011 #

cemerick Chas Emerick
@darevay Really, the editor can't keep up? Ouch. ccw had similar issues until @cgrand's parsley saved the day. bit.ly/urSYwv

December 18, 2011 #

kotarak Meikel Brandmeyer
@cemerick I doubt that this is the case. I edited much larger files without problems. /cc @darevay

December 18, 2011 #

darevay Dave Ray
@kotarak @cemerick yeah. It keeps up fine. Last night I noticed indenting seemed slow, but I need to investigate further.

December 18, 2011 #