innov
/
django1
1
0
Fork 0
Code Issues Pull Requests 1 Projects Releases Wiki Activity

Various documentation edits from the past few changesets 

git-svn-id: http://code.djangoproject.com/svn/django/trunk@7619 bcc190cf-cafb-0310-a4f2-bffc1f526a37
This commit is contained in:
Adrian Holovaty 2008-06-12 03:36:48 +00:00
parent 9c50495464
commit daab1f0681
5 changed files with 50 additions and 48 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
docs/authentication.txt
View File

@ -270,17 +270,17 @@ to create a superuser at a later date, you can use a command line utility.
manage.py createsuperuser --username=joe --email=joe@example.com manage.py createsuperuser --username=joe --email=joe@example.com
You will be prompted for a password. Once entered, the user is created. If you You will be prompted for a password. After you enter one, the user will be
leave off the ``--username`` or the ``--email`` option, It will prompt you for created immediately. If you leave off the ``--username`` or the ``--email``
those values as well. options, it will prompt you for those values.
If you're using an older release of Django, the old way of creating a superuser If you're using an older release of Django, the old way of creating a superuser
on the command line still works:: on the command line still works::
python /path/to/django/contrib/auth/create_superuser.py python /path/to/django/contrib/auth/create_superuser.py
Where ``/path/to`` is the path to the Django codebase on your filesystem. The ...where ``/path/to`` is the path to the Django codebase on your filesystem. The
``manage.py`` command is prefered since it'll figure out the correct path and ``manage.py`` command is preferred because it figures out the correct path and
environment for you. environment for you.
Storing additional information about users Storing additional information about users

8
docs/django-admin.txt
View File

@ -104,14 +104,14 @@ do so during ``syncdb``, or if you need to programmatically generate
superuser accounts for your site(s). superuser accounts for your site(s).
When run interactively, this command will prompt for a password for When run interactively, this command will prompt for a password for
the new superuser account; when run non-interactively, no password the new superuser account. When run non-interactively, no password
will be set and the superuser account will not be able to log in until will be set, and the superuser account will not be able to log in until
a password has been manually set for it. a password has been manually set for it.
The username and e-mail address for the new account can be supplied by The username and e-mail address for the new account can be supplied by
using the ``--username`` and ``--email`` arguments on the command using the ``--username`` and ``--email`` arguments on the command
line; if not supplied, ``createsuperuser`` will prompt for them when line. If either of those is not supplied, ``createsuperuser`` will prompt for
running interactively. it when running interactively.
This command is only available if Django's `authentication system`_ This command is only available if Django's `authentication system`_
(``django.contrib.auth``) is installed. (``django.contrib.auth``) is installed.

48
docs/faq.txt
View File

@ -646,7 +646,7 @@ You can also use the Python API. See `creating users`_ for full info.
.. _creating users: ../authentication/#creating-users .. _creating users: ../authentication/#creating-users
Getting Help Getting help
============ ============
How do I do X? Why doesn't Y work? Where can I go to get help? How do I do X? Why doesn't Y work? Where can I go to get help?
@ -656,8 +656,8 @@ If this FAQ doesn't contain an answer to your question, you might want to
try the `django-users mailing list`_. Feel free to ask any question related try the `django-users mailing list`_. Feel free to ask any question related
to installing, using, or debugging Django. to installing, using, or debugging Django.
If you prefer IRC, the `#django IRC channel`_ on freenode is an active If you prefer IRC, the `#django IRC channel`_ on the Freenode IRC network is an
community of helpful individuals who may be able to solve your problem. active community of helpful individuals who may be able to solve your problem.
.. _`django-users mailing list`: http://groups.google.com/group/django-users .. _`django-users mailing list`: http://groups.google.com/group/django-users
.. _`#django IRC channel`: irc://irc.freenode.net/django .. _`#django IRC channel`: irc://irc.freenode.net/django
@ -666,7 +666,7 @@ Why hasn't my message appeared on django-users?
----------------------------------------------- -----------------------------------------------
django-users_ has a lot of subscribers. This is good for the community, as django-users_ has a lot of subscribers. This is good for the community, as
there are lot of people that can contribute answers to questions. it means many people are available to contribute answers to questions.
Unfortunately, it also means that django-users_ is an attractive target for Unfortunately, it also means that django-users_ is an attractive target for
spammers. spammers.
@ -678,23 +678,24 @@ inconvenience that this policy may cause.
.. _django-users: http://groups.google.com/group/django-users .. _django-users: http://groups.google.com/group/django-users
Nobody on django-users answered my question? What should I do? Nobody on django-users answered my question! What should I do?
-------------------------------------------------------------- --------------------------------------------------------------
Wait. Ask again later. Try making your question more specific, or provide Try making your question more specific, or provide a better example of your
a better example of your problem. problem.
Remember, the readers of django-users_ are all volunteers. If nobody has As with most open-source mailing lists, the folks on django-users_ are
answered your question, it may be because nobody knows the answer, it may volunteers. If nobody has answered your question, it may be because nobody
be because nobody can understand the question, or it may be that everybody knows the answer, it may be because nobody can understand the question, or it
that can help is extremely busy. may be that everybody that can help is busy. One thing you might try is to ask
the question on IRC -- visit the `#django IRC channel`_ on the Freenode IRC
network.
Resist any temptation to mail the `django-developers mailing list`_ in an You might notice we have a second mailing list, called django-developers_ --
attempt to get an answer to your question. django-developers_ is for discussing but please don't e-mail support questions to this mailing list. This list is
the development of Django itself. Attempts to use django-developers_ as for discussion of the development of Django itself. Asking a tech support
a second-tier support mechanism will not be met an enthusiastic response. question there is considered quite impolite.
.. _`django-developers mailing list`: http://groups.google.com/group/django-developers
.. _django-developers: http://groups.google.com/group/django-developers .. _django-developers: http://groups.google.com/group/django-developers
I think I've found a bug! What should I do? I think I've found a bug! What should I do?
@ -708,10 +709,9 @@ Detailed instructions on how to handle a potential bug can be found in our
I think I've found a security problem! What should I do? I think I've found a security problem! What should I do?
-------------------------------------------------------- --------------------------------------------------------
If you think you have found a security problem with Django, please send If you think you've found a security problem with Django, please send a message
a message to security@djangoproject.com. This is a private list only to security@djangoproject.com. This is a private list only open to long-time,
open to long-time, highly trusted Django developers, and its archives highly trusted Django developers, and its archives are not publicly readable.
are not publicly readable.
Due to the sensitive nature of security issues, we ask that if you think you Due to the sensitive nature of security issues, we ask that if you think you
have found a security problem, *please* don't send a message to one of the have found a security problem, *please* don't send a message to one of the
@ -742,10 +742,10 @@ ignored" and "a ticket has not been attended to yet." Django's ticket system
contains hundreds of open tickets, of various degrees of impact on end-user contains hundreds of open tickets, of various degrees of impact on end-user
functionality, and Django's developers have to review and prioritize. functionality, and Django's developers have to review and prioritize.
On top of that - the team working on Django are all volunteers. As a result, On top of that: the people who work on Django are all volunteers. As a result,
the amount of time that we have to work on Django is limited, and will vary the amount of time that we have to work on the framework is limited and will
from week to week depending on how much spare time we have. If we are busy, we vary from week to week depending on our spare time. If we're busy, we may not
may not be able to spend as much time on Django as we might want. be able to spend as much time on Django as we might want.
Besides, if your feature request stands no chance of inclusion in Django, we Besides, if your feature request stands no chance of inclusion in Django, we
won't ignore it -- we'll just close the ticket. So if your ticket is still won't ignore it -- we'll just close the ticket. So if your ticket is still

8
docs/sessions.txt
View File

@ -139,10 +139,10 @@ It also has these methods:
in 5 minutes. in 5 minutes.
* If ``value`` is a ``datetime`` or ``timedelta`` object, the * If ``value`` is a ``datetime`` or ``timedelta`` object, the
session will expire at that specific time. session will expire at that specific date/time.
* If ``value`` is ``0`` then the user's session cookie will expire * If ``value`` is ``0``, the user's session cookie will expire
when their browser is closed. when the user's Web browser is closed.
* If ``value`` is ``None``, the session reverts to using the global * If ``value`` is ``None``, the session reverts to using the global
session expiry policy. session expiry policy.
@ -168,7 +168,7 @@ It also has these methods:
**New in Django development version** **New in Django development version**
Returns either ``True`` or ``False``, depending on whether the user's Returns either ``True`` or ``False``, depending on whether the user's
session cookie will expire when their browser is closed. session cookie will expire when the user's Web browser is closed.
You can edit ``request.session`` at any point in your view. You can edit it You can edit ``request.session`` at any point in your view. You can edit it
multiple times. multiple times.

2
docs/settings.txt
View File

@ -394,6 +394,8 @@ site with ``DEBUG`` turned on.
DEBUG_PROPAGATE_EXCEPTIONS DEBUG_PROPAGATE_EXCEPTIONS
-------------------------- --------------------------
**New in Django development version**
Default: ``False`` Default: ``False``
If set to True, Django's normal exception handling of view functions If set to True, Django's normal exception handling of view functions