Clojure

def should support an optional doc-string

Details

  • Type: Enhancement Enhancement
  • Status: Closed Closed
  • Resolution: Completed
  • Affects Version/s: None
  • Fix Version/s: Release 1.3
  • Component/s: None
  • Labels:
    None
  • Approval:
    Ok

Description

To be more consistent across all "operators that introduce names", def should support an optional docstring after the name.

Activity

Ascending order - Click to sort in descending order
Hide
Permalink
Assembla Importer added a comment -

bsteuber said: [file:cwJXMqr-Kr35PieJe5aVNr]

Show
Assembla Importer added a comment - bsteuber said: [file:cwJXMqr-Kr35PieJe5aVNr]
Hide
Permalink
Assembla Importer added a comment -

bsteuber said: Contributor Agreement coming soon..

Show
Assembla Importer added a comment - bsteuber said: Contributor Agreement coming soon..
Hide
Permalink
Assembla Importer added a comment -

bsteuber said: Now it arrived

Show
Assembla Importer added a comment - bsteuber said: Now it arrived
Hide
Permalink
Assembla Importer added a comment -

stu said: [file:bOM0ly1umr36tseJe5cbLA]

Show
Assembla Importer added a comment - stu said: [file:bOM0ly1umr36tseJe5cbLA]
Hide
Permalink
Assembla Importer added a comment -

stu said: Second patch subsumes first and adds some minor cleanup.

Show
Assembla Importer added a comment - stu said: Second patch subsumes first and adds some minor cleanup.
Hide
Permalink
Assembla Importer added a comment -

stu said: Updating tickets (#276, #280, #378, #437, #448)

Show
Assembla Importer added a comment - stu said: Updating tickets (#276, #280, #378, #437, #448)
Hide
Permalink
Benjamin Teuber added a comment -

In my initial patch, I forgot to update clojure.repl to have (doc def) mention the optional docstring. I've written a patch for this small doc update, but it seems I can't upload it anymore in a closed issue. Should I just mail it to someone?

Show
Benjamin Teuber added a comment - In my initial patch, I forgot to update clojure.repl to have (doc def) mention the optional docstring. I've written a patch for this small doc update, but it seems I can't upload it anymore in a closed issue. Should I just mail it to someone?
Hide
Permalink
Stuart Halloway added a comment -

I made this change before seeing your comment.

Show
Stuart Halloway added a comment - I made this change before seeing your comment.
Hide
Permalink
Benjamin Teuber added a comment -

I see - funny coincedence
My patch had the additional sentence

"An optional documentation string can be supplied (only when init is given, too)."

at the end of the documentation to be clear about what happens when only one of init and doc is given, but I'm not sure this really is necessary.

Loved your book by the way

Show
Benjamin Teuber added a comment - I see - funny coincedence My patch had the additional sentence "An optional documentation string can be supplied (only when init is given, too)." at the end of the documentation to be clear about what happens when only one of init and doc is given, but I'm not sure this really is necessary. Loved your book by the way

People

  • Assignee:
    Unassigned
    Reporter:
    Anonymous
Vote (0)
Watch (2)

Dates

  • Created:
    Updated:
    Resolved:
Atlassian JIRA (v4.4#649-r158309) | Report a problem
Powered by a free Atlassian JIRA open source license for Clojure. Try JIRA - bug tracking software for your team.