This week's book giveaway is in the Clojure forum.
We're giving away four copies of Clojure in Action and have Amit Rathore and Francis Avila on-line!
See this thread for details.
Win a copy of Clojure in Action this week in the Clojure forum!
  • Post Reply
  • Bookmark Topic Watch Topic
  • New Topic

Javadoc for the plural form of a class

 
Ryan Small
Greenhorn
Posts: 3
Eclipse IDE Java Netbeans IDE
  • 0
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Assuming that I have a class named Service, how would I write a reference to the plural form of it in the Javadoc?

1. It doesn't seem right to use {@code Services} since "Services" isn't a class.
2. It seems even more awkward to write {@code Service}s.

 
Roel De Nijs
Sheriff
Posts: 9117
75
AngularJS Chrome Eclipse IDE Hibernate Java jQuery MySQL Database Spring Tomcat Server
  • 0
  • Mark post as helpful
  • send pies
  • Quote
  • Report post to moderator
Certainly would not opt for 1, because the reason you gave. I would opt for your 2nd option. It would be maybe awkward to write, but the output would be "Services" (that's also how it's done in e.g. the SCJP K&B books).
 
Consider Paul's rocket mass heater.
  • Post Reply
  • Bookmark Topic Watch Topic
  • New Topic