NOTE: This documentation is not client-specific and is provided here for
convenience only. It may be out of date; at time of writing, this information
is also available at
<http://www.livejournal.com/support/faqbrowse.bml?faqid=69>, which is
referenced from <http://www.livejournal.com/support/faq.bml>.

Paid and permanent account users may create polls in their entries; this is
done by using the following LJ tags. For information on LJ tags in general, see
lj-html-tags. There is also a Poll Creator at
<http://www.livejournal.com/poll/create.bml>.

<lj-poll>...</lj-poll>
----------------------
Creates a new poll. It supports the following optional attributes:

name="pollname"
	Gives a name to the poll. It may be freely chosen.

whovote="all"
whovote="friends"
	Who may vote in the poll--either all LiveJournal users, or only those
	on your Friends list. For polls in a community journal, "friends"
	refers to the members of the community. "all" is default.

whoview="all"
whoview="friends"
whoview="none"
	Who may view the results of the poll, with a breakdown of who answered
	what. "all" and "friends" mean the same as whovote, while "none" means
	only the creator of the poll may view the results. (I think anyone may
	view the aggregate results regardless of the option.) "all" is default.

Example:
	<lj-poll name="RMS Popularity" whovote="friends" whoview="none">

	Creates a poll named "RMS Popularity", open only to your friends, with
	the detailed results viewable only to you.

<lj-pq>...</lj-pq>
------------------
Creates a question in the poll. The "type" attribute is required:

type="radio"
type="drop"
	radio and drop also require <lj-pi>...</lj-pi> tags inside of them.

	radio and drop create a set of items that people may select only one
	choice from. The difference between them is that radio creates a list
	of the items right on the page, and drop creates a box which pops up a
	menu of choices when clicked.

type="check"
	check also requires <lj-pi>...</lj-pi> tags inside of it.

	check creates a set of items that people may select any number of
	choices from.

type="text"
	text creates a box which people can type into, as a short answer. The
	size of the box can be further controlled by the following optional
	attributes:

	size=#
		Make the box # characters wide. Default 30?
	
	maxlength=#
		Make the box accept up to # characters of input. Default 50?
		Maximum 255? (Maximum may be 100 chars/255 bytes because of
		the UTF-8 switch.)

type="scale"
	scale creates a certain range of numbers for people to select. It's
	often used for rating things. By default, it will range from 1 to 10,
	but it can be changed by the optional attributes:

	from=#
		Minimum number on the scale. Must be >= 1.

	to=#
		Maximum number on the scale. Presumably, it must be greater
		than from.

	by=#
		How many numbers are between options. For example, from=1
		to=1000 by 100 will give choices at 1, 100, 200, and so on.

	From, to, and by must be combined so that there are no more than 20
	options on the scale. 1-100 by 5 is allowed, but 1-100 by 2 is not.

For examples of all the types, see below, after <lj-pi>.

<lj-pi>...</lj-pi>
------------------
Creates an item for radio, check, and drop questions. These must be used within
<lj-pq> tags.

Examples of <lj-pq> and <lj-pi>
-------------------------------
Entry text:
	<lj-poll name="TPS Report Review" whovote="friends" whoview="none">

	<lj-pq type="radio">
	Do TPS reports require a cover sheet?
	<lj-pi>Yes</lj-pi>
	<lj-pi>No</lj-pi>
	<lj-pi>I don't know&mdash;I didn't get the memo</lj-pi>
	</lj-pq>

	<lj-pq type="check">
	TPS reports can be used for:
	<lj-pi>Cleaning fish</lj-pi>
	<lj-pi>Inside jokes</lj-pi>
	</lj-pq>

	<lj-pq type="drop">
	TPS reports are most popular in the state of:
	<lj-pi>Alabama</lj-pi>
	<lj-pi>New York (but they're taxed 63% except on Christmas)</lj-pi>
	<lj-pi>North Dakota (but nobody's there to notice)</lj-pi>
	<lj-pi>Zimbabwe (CowboyNeal's homeland)</lj-pi>
	</lj-pq>

	<lj-pq type="text" size="20" maxlength="100">
	What does TPS stand for?
	</lj-pq>

	<lj-pq type="scale" from="1" to="16" by="1">
	How cool am I? (1=not cool at all, 16=cooler than liquid helium)
	</lj-pq>

Approximate rendering:
	Poll #31337: TPS Report Review
	Open to: friends, results viewable to: none

	Do TPS reports require a cover sheet?
	  ( ) Yes
	  ( ) No
	  ( ) I don't know--I didn't get the memo

	TPS reports can be used for:
	  [ ] Cleaning fish
	  [ ] Inside jokes

	TPS reports are most popular in the state of:
	  ____________________________
	  |Alabama                 |v|
	  ----------------------------

	What does TPS stand for?
	   __________________________
	  |__________________________|

	How cool am I (1=not cool at all, 16=cooler than liquid helium)
	  _______
	  |1  |v|
	  -------

	  _____________
	 | Submit Poll |
	  -------------

