Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Docs need to list valid SDL constants #27

Closed
kthakore opened this issue Jul 26, 2011 · 17 comments
Closed

Docs need to list valid SDL constants #27

kthakore opened this issue Jul 26, 2011 · 17 comments
Assignees

Comments

@kthakore
Copy link
Member

Having to manually search Constants.pm for valid constants is a pain, and probably the source of many "magic values".

Ideally, each method call should be documented with a list of valid constants. I realize that this is a task of near-epic proportions.

As a start, an exhaustive list should be shown (or referred to) in the SDL documentation.

@kthakore
Copy link
Member Author

Author: kthakore
Time: 1254817437
Field: keywords
Value: Pod

@ghost ghost assigned kthakore Jul 26, 2011
@kthakore
Copy link
Member Author

Author: kthakore
Time: 1254817437
Field: difficulty
Value: Easy

@kthakore
Copy link
Member Author

Author: kthakore
Time: 1254817437
Field: type
Value: task

@kthakore
Copy link
Member Author

Author: kthakore
Time: 1254817437
Field: milestone
Value: Exit Legacy

@kthakore
Copy link
Member Author

Author: kthakore
Time: 1254817437
Field: comment
Value:

@kthakore
Copy link
Member Author

Author: garu
Time: 1254980591
Field: comment
Value: Just so people can help, the task ahead is:

  • open SDL/Constant.pm
  • create a pod for each Constant, describing it.
  • group constants in pod by their purpose (i.e. where each set should be used.

@kthakore
Copy link
Member Author

Author: garu
Time: 1254982069
Field: blocking
Value: 25

@kthakore
Copy link
Member Author

Author: kthakore
Time: 1257958743
Field: status
Value: assigned

@kthakore
Copy link
Member Author

Author: kthakore
Time: 1257958743
Field: owner
Value: selvaraj

@kthakore
Copy link
Member Author

Author: kthakore
Time: 1257958743
Field: comment
Value:

@kthakore
Copy link
Member Author

Author: FROGGS
Time: 1269299546
Field: status
Value: accepted

@kthakore
Copy link
Member Author

Author: FROGGS
Time: 1269299546
Field: owner
Value: FROGGS

@kthakore
Copy link
Member Author

Author: FROGGS
Time: 1269299546
Field: comment
Value: for Pango and TTF they are in their namespace. Other modules will follow.

@kthakore
Copy link
Member Author

Author: FROGGS
Time: 1269299613
Field: comment
Value: Constants are documented in the pods in the CONSTANTS section (right above METHODS).

@kthakore
Copy link
Member Author

Author: FROGGS
Time: 1269561235
Field: status
Value: closed

@kthakore
Copy link
Member Author

Author: FROGGS
Time: 1269561235
Field: resolution
Value: fixed

@kthakore
Copy link
Member Author

Author: FROGGS
Time: 1269561235
Field: comment
Value: Done

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant