porting IDE tooltip-friendly documentation tweaks from Aurora-Sim

Signed-off-by: BlueWall <jamesh@bluewallgroup.com>
0.7.4.1
SignpostMarv 2012-05-24 15:47:40 +01:00 committed by BlueWall
parent f4cd4c8e28
commit 87f9aa9d08
1 changed files with 218 additions and 129 deletions

View File

@ -28,143 +28,232 @@
namespace OpenSim.Framework.Servers.HttpServer namespace OpenSim.Framework.Servers.HttpServer
{ {
/// <summary> /// <summary>
/// HTTP status codes (almost) as defined by W3C in /// HTTP status codes (almost) as defined by W3C in http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
/// http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html
/// </summary> /// </summary>
public enum OSHttpStatusCode: int public enum OSHttpStatusCode: int
{ {
// 1xx Informational status codes providing a provisional #region 1xx Informational status codes providing a provisional response.
// response.
// 100 Tells client that to keep on going sending its request /// <summary>
/// 100 Tells client that to keep on going sending its request
/// </summary>
InfoContinue = 100, InfoContinue = 100,
// 101 Server understands request, proposes to switch to different
// application level protocol /// <summary>
/// 101 Server understands request, proposes to switch to different application level protocol
/// </summary>
InfoSwitchingProtocols = 101, InfoSwitchingProtocols = 101,
#endregion
// 2xx Success codes #region 2xx Success codes
// 200 Request successful
/// <summary>
/// 200 Request successful
/// </summary>
SuccessOk = 200, SuccessOk = 200,
// 201 Request successful, new resource created
/// <summary>
/// 201 Request successful, new resource created
/// </summary>
SuccessOkCreated = 201, SuccessOkCreated = 201,
// 202 Request accepted, processing still on-going
/// <summary>
/// 202 Request accepted, processing still on-going
/// </summary>
SuccessOkAccepted = 202, SuccessOkAccepted = 202,
// 203 Request successful, meta information not authoritative
/// <summary>
/// 203 Request successful, meta information not authoritative
/// </summary>
SuccessOkNonAuthoritativeInformation = 203, SuccessOkNonAuthoritativeInformation = 203,
// 204 Request successful, nothing to return in the body
/// <summary>
/// 204 Request successful, nothing to return in the body
/// </summary>
SuccessOkNoContent = 204, SuccessOkNoContent = 204,
// 205 Request successful, reset displayed content
/// <summary>
/// 205 Request successful, reset displayed content
/// </summary>
SuccessOkResetContent = 205, SuccessOkResetContent = 205,
// 206 Request successful, partial content returned
/// <summary>
/// 206 Request successful, partial content returned
/// </summary>
SuccessOkPartialContent = 206, SuccessOkPartialContent = 206,
// 3xx Redirect code: user agent needs to go somewhere else #endregion
// 300 Redirect: different presentation forms available, take
// a pick #region 3xx Redirect code: user agent needs to go somewhere else
/// <summary>
/// 300 Redirect: different presentation forms available, take a pick
/// </summary>
RedirectMultipleChoices = 300, RedirectMultipleChoices = 300,
// 301 Redirect: requested resource has moved and now lives
// somewhere else /// <summary>
/// 301 Redirect: requested resource has moved and now lives somewhere else
/// </summary>
RedirectMovedPermanently = 301, RedirectMovedPermanently = 301,
// 302 Redirect: Resource temporarily somewhere else, location
// might change /// <summary>
/// 302 Redirect: Resource temporarily somewhere else, location might change
/// </summary>
RedirectFound = 302, RedirectFound = 302,
// 303 Redirect: See other as result of a POST
/// <summary>
/// 303 Redirect: See other as result of a POST
/// </summary>
RedirectSeeOther = 303, RedirectSeeOther = 303,
// 304 Redirect: Resource still the same as before
/// <summary>
/// 304 Redirect: Resource still the same as before
/// </summary>
RedirectNotModified = 304, RedirectNotModified = 304,
// 305 Redirect: Resource must be accessed via proxy provided
// in location field /// <summary>
/// 305 Redirect: Resource must be accessed via proxy provided in location field
/// </summary>
RedirectUseProxy = 305, RedirectUseProxy = 305,
// 307 Redirect: Resource temporarily somewhere else, location
// might change /// <summary>
/// 307 Redirect: Resource temporarily somewhere else, location might change
/// </summary>
RedirectMovedTemporarily = 307, RedirectMovedTemporarily = 307,
// 4xx Client error: the client borked the request #endregion
// 400 Client error: bad request, server does not grok what
// the client wants #region 4xx Client error: the client borked the request
/// <summary>
/// 400 Client error: bad request, server does not grok what the client wants
/// </summary>
ClientErrorBadRequest = 400, ClientErrorBadRequest = 400,
// 401 Client error: the client is not authorized, response
// provides WWW-Authenticate header field with a challenge /// <summary>
/// 401 Client error: the client is not authorized, response provides WWW-Authenticate header field with a challenge
/// </summary>
ClientErrorUnauthorized = 401, ClientErrorUnauthorized = 401,
// 402 Client error: Payment required (reserved for future use)
/// <summary>
/// 402 Client error: Payment required (reserved for future use)
/// </summary>
ClientErrorPaymentRequired = 402, ClientErrorPaymentRequired = 402,
// 403 Client error: Server understood request, will not
// deliver, do not try again. /// <summary>
/// 403 Client error: Server understood request, will not deliver, do not try again.
ClientErrorForbidden = 403, ClientErrorForbidden = 403,
// 404 Client error: Server cannot find anything matching the
// client request. /// <summary>
/// 404 Client error: Server cannot find anything matching the client request.
/// </summary>
ClientErrorNotFound = 404, ClientErrorNotFound = 404,
// 405 Client error: The method specified by the client in the
// request is not allowed for the resource requested /// <summary>
/// 405 Client error: The method specified by the client in the request is not allowed for the resource requested
/// </summary>
ClientErrorMethodNotAllowed = 405, ClientErrorMethodNotAllowed = 405,
// 406 Client error: Server cannot generate suitable response
// for the resource and content characteristics requested by /// <summary>
// the client /// 406 Client error: Server cannot generate suitable response for the resource and content characteristics requested by the client
/// </summary>
ClientErrorNotAcceptable = 406, ClientErrorNotAcceptable = 406,
// 407 Client error: Similar to 401, Server requests that
// client authenticate itself with the proxy first /// <summary>
/// 407 Client error: Similar to 401, Server requests that client authenticate itself with the proxy first
/// </summary>
ClientErrorProxyAuthRequired = 407, ClientErrorProxyAuthRequired = 407,
// 408 Client error: Server got impatient with client and
// decided to give up waiting for the client's request to /// <summary>
// arrive /// 408 Client error: Server got impatient with client and decided to give up waiting for the client's request to arrive
/// </summary>
ClientErrorRequestTimeout = 408, ClientErrorRequestTimeout = 408,
// 409 Client error: Server could not fulfill the request for
// a resource as there is a conflict with the current state of /// <summary>
// the resource but thinks client can do something about this /// 409 Client error: Server could not fulfill the request for a resource as there is a conflict with the current state of the resource but thinks client can do something about this
/// </summary>
ClientErrorConflict = 409, ClientErrorConflict = 409,
// 410 Client error: The resource has moved somewhere else,
// but server has no clue where. /// <summary>
/// 410 Client error: The resource has moved somewhere else, but server has no clue where.
/// </summary>
ClientErrorGone = 410, ClientErrorGone = 410,
// 411 Client error: The server is picky again and insists on
// having a content-length header field in the request /// <summary>
/// 411 Client error: The server is picky again and insists on having a content-length header field in the request
/// </summary>
ClientErrorLengthRequired = 411, ClientErrorLengthRequired = 411,
// 412 Client error: one or more preconditions supplied in the
// client's request is false /// <summary>
/// 412 Client error: one or more preconditions supplied in the client's request is false
/// </summary>
ClientErrorPreconditionFailed = 412, ClientErrorPreconditionFailed = 412,
// 413 Client error: For fear of reflux, the server refuses to
// swallow that much data. /// <summary>
/// 413 Client error: For fear of reflux, the server refuses to swallow that much data.
/// </summary>
ClientErrorRequestEntityToLarge = 413, ClientErrorRequestEntityToLarge = 413,
// 414 Client error: The server considers the Request-URI to
// be indecently long and refuses to even look at it. /// <summary>
/// 414 Client error: The server considers the Request-URI to be indecently long and refuses to even look at it.
/// </summary>
ClientErrorRequestURITooLong = 414, ClientErrorRequestURITooLong = 414,
// 415 Client error: The server has no clue about the media
// type requested by the client (contrary to popular belief it /// <summary>
// is not a warez server) /// 415 Client error: The server has no clue about the media type requested by the client (contrary to popular belief it is not a warez server)
/// </summary>
ClientErrorUnsupportedMediaType = 415, ClientErrorUnsupportedMediaType = 415,
// 416 Client error: The requested range cannot be delivered
// by the server. /// <summary>
/// 416 Client error: The requested range cannot be delivered by the server.
/// </summary>
ClientErrorRequestRangeNotSatisfiable = 416, ClientErrorRequestRangeNotSatisfiable = 416,
// 417 Client error: The expectations of the client as
// expressed in one or more Expect header fields cannot be met /// <summary>
// by the server, the server is awfully sorry about this. /// 417 Client error: The expectations of the client as expressed in one or more Expect header fields cannot be met by the server, the server is awfully sorry about this.
/// </summary>
ClientErrorExpectationFailed = 417, ClientErrorExpectationFailed = 417,
// 499 Client error: Wildcard error.
/// <summary>
/// 499 Client error: Wildcard error.
/// </summary>
ClientErrorJoker = 499, ClientErrorJoker = 499,
// 5xx Server errors (rare) #endregion
// 500 Server error: something really strange and unexpected
// happened #region 5xx Server errors (rare)
/// <summary>
/// 500 Server error: something really strange and unexpected happened
/// </summary>
ServerErrorInternalError = 500, ServerErrorInternalError = 500,
// 501 Server error: The server does not do the functionality
// required to carry out the client request. not at /// <summary>
// all. certainly not before breakfast. but also not after /// 501 Server error: The server does not do the functionality required to carry out the client request. not at all. certainly not before breakfast. but also not after breakfast.
// breakfast. /// </summary>
ServerErrorNotImplemented = 501, ServerErrorNotImplemented = 501,
// 502 Server error: While acting as a proxy or a gateway, the
// server got ditched by the upstream server and as a /// <summary>
// consequence regretfully cannot fulfill the client's request /// 502 Server error: While acting as a proxy or a gateway, the server got ditched by the upstream server and as a consequence regretfully cannot fulfill the client's request
/// </summary>
ServerErrorBadGateway = 502, ServerErrorBadGateway = 502,
// 503 Server error: Due to unforseen circumstances the server
// cannot currently deliver the service requested. Retry-After /// <summary>
// header might indicate when to try again. /// 503 Server error: Due to unforseen circumstances the server cannot currently deliver the service requested. Retry-After header might indicate when to try again.
/// </summary>
ServerErrorServiceUnavailable = 503, ServerErrorServiceUnavailable = 503,
// 504 Server error: The server blames the upstream server
// for not being able to deliver the service requested and /// <summary>
// claims that the upstream server is too slow delivering the /// 504 Server error: The server blames the upstream server for not being able to deliver the service requested and claims that the upstream server is too slow delivering the goods.
// goods. /// </summary>
ServerErrorGatewayTimeout = 504, ServerErrorGatewayTimeout = 504,
// 505 Server error: The server does not support the HTTP
// version conveyed in the client's request. /// <summary>
/// 505 Server error: The server does not support the HTTP version conveyed in the client's request.
/// </summary>
ServerErrorHttpVersionNotSupported = 505, ServerErrorHttpVersionNotSupported = 505,
#endregion
} }
} }