Django

Code

Changeset 7619

Show
Ignore:
Timestamp:
06/11/08 22:36:48 (4 months ago)
Author:
adrian
Message:

Various documentation edits from the past few changesets

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved
  • django/trunk/docs/authentication.txt

    r7590 r7619  
    271271    manage.py createsuperuser --username=joe --email=joe@example.com 
    272272 
    273 You will be prompted for a password. Once entered, the user is created. If you 
    274 leave off the ``--username`` or the ``--email`` option, It will prompt you for 
    275 those values as well
     273You will be prompted for a password. After you enter one, the user will be 
     274created immediately. If you leave off the ``--username`` or the ``--email`` 
     275options, it will prompt you for those values
    276276 
    277277If you're using an older release of Django, the old way of creating a superuser 
     
    280280    python /path/to/django/contrib/auth/create_superuser.py 
    281281 
    282 Where ``/path/to`` is the path to the Django codebase on your filesystem. The 
    283 ``manage.py`` command is prefered since it'll figure out the correct path and 
     282...where ``/path/to`` is the path to the Django codebase on your filesystem. The 
     283``manage.py`` command is preferred because it figures out the correct path and 
    284284environment for you. 
    285285 
  • django/trunk/docs/django-admin.txt

    r7615 r7619  
    105105 
    106106When run interactively, this command will prompt for a password for 
    107 the new superuser account; when run non-interactively, no password 
    108 will be set and the superuser account will not be able to log in until 
     107the new superuser account. When run non-interactively, no password 
     108will be set, and the superuser account will not be able to log in until 
    109109a password has been manually set for it. 
    110110 
    111111The username and e-mail address for the new account can be supplied by 
    112112using the ``--username`` and ``--email`` arguments on the command 
    113 line; if not supplied, ``createsuperuser`` will prompt for them when 
    114 running interactively. 
     113line. If either of those is not supplied, ``createsuperuser`` will prompt for 
     114it when running interactively. 
    115115 
    116116This command is only available if Django's `authentication system`_ 
  • django/trunk/docs/faq.txt

    r7602 r7619  
    227227Short answer: When we're comfortable with Django's APIs, have added all 
    228228features that we feel are necessary to earn a "1.0" status, and are ready to 
    229 begin maintaining backwards compatibility.  
     229begin maintaining backwards compatibility. 
    230230 
    231231The merging of Django's `Queryset Refactor branch`_ went a long way toward Django 
     
    261261would be happy to help you. 
    262262 
    263 You might also be interested in posting a job to http://djangogigs.com/ .  
    264 If you want to find Django-capable people in your local area, try  
     263You might also be interested in posting a job to http://djangogigs.com/ . 
     264If you want to find Django-capable people in your local area, try 
    265265http://djangopeople.net/ . 
    266266 
     
    647647.. _creating users: ../authentication/#creating-users 
    648648 
    649 Getting Help 
     649Getting help 
    650650============ 
    651651 
     
    654654 
    655655If this FAQ doesn't contain an answer to your question, you might want to 
    656 try the `django-users mailing list`_. Feel free to ask any question related  
    657 to installing, using, or debugging Django.  
    658  
    659 If you prefer IRC, the `#django IRC channel`_ on freenode is an active 
    660 community of helpful individuals who may be able to solve your problem.  
     656try the `django-users mailing list`_. Feel free to ask any question related 
     657to installing, using, or debugging Django. 
     658 
     659If you prefer IRC, the `#django IRC channel`_ on the Freenode IRC network is an 
     660active community of helpful individuals who may be able to solve your problem. 
    661661 
    662662.. _`django-users mailing list`: http://groups.google.com/group/django-users 
     
    667667 
    668668django-users_ has a lot of subscribers. This is good for the community, as 
    669 there are lot of people that can contribute answers to questions. 
     669it means many people are available to contribute answers to questions. 
    670670Unfortunately, it also means that django-users_ is an attractive target for 
    671 spammers.  
     671spammers. 
    672672 
    673673In order to combat the spam problem, when you join the django-users_ mailing 
    674 list, we manually moderate the first message you send to the list. This means  
    675 that spammers get caught, but it also means that your first question to the  
     674list, we manually moderate the first message you send to the list. This means 
     675that spammers get caught, but it also means that your first question to the 
    676676list might take a little longer to get answered. We apologize for any 
    677677inconvenience that this policy may cause. 
     
    679679.. _django-users: http://groups.google.com/group/django-users 
    680680 
    681 Nobody on django-users answered my question? What should I do? 
     681Nobody on django-users answered my question! What should I do? 
    682682-------------------------------------------------------------- 
    683683 
    684 Wait. Ask again later. Try making your question more specific, or provide 
    685 a better example of your problem. 
    686  
    687 Remember, the readers of django-users_ are all volunteers. If nobody has 
    688 answered your question, it may be because nobody knows the answer, it may 
    689 be because nobody can understand the question, or it may be that everybody 
    690 that can help is extremely busy. 
    691  
    692 Resist any temptation to mail the `django-developers mailing list`_ in an  
    693 attempt to get an answer to your question. django-developers_ is for discussing  
    694 the development of Django itself. Attempts to use django-developers_ as 
    695 a second-tier support mechanism will not be met an enthusiastic response. 
    696  
    697 .. _`django-developers mailing list`: http://groups.google.com/group/django-developers 
     684Try making your question more specific, or provide a better example of your 
     685problem. 
     686 
     687As with most open-source mailing lists, the folks on django-users_ are 
     688volunteers. If nobody has answered your question, it may be because nobody 
     689knows the answer, it may be because nobody can understand the question, or it 
     690may be that everybody that can help is busy. One thing you might try is to ask 
     691the question on IRC -- visit the `#django IRC channel`_ on the Freenode IRC 
     692network. 
     693 
     694You might notice we have a second mailing list, called django-developers_ -- 
     695but please don't e-mail support questions to this mailing list. This list is 
     696for discussion of the development of Django itself. Asking a tech support 
     697question there is considered quite impolite. 
     698 
    698699.. _django-developers: http://groups.google.com/group/django-developers 
    699700 
     
    709710-------------------------------------------------------- 
    710711 
    711 If you think you have found a security problem with Django, please send  
    712 a message to security@djangoproject.com. This is a private list only 
    713 open to long-time, highly trusted Django developers, and its archives  
    714 are not publicly readable.  
     712If you think you've found a security problem with Django, please send a message 
     713to security@djangoproject.com. This is a private list only open to long-time, 
     714highly trusted Django developers, and its archives are not publicly readable. 
    715715 
    716716Due to the sensitive nature of security issues, we ask that if you think you 
    717 have found a security problem, *please* don't send a message to one of the  
     717have found a security problem, *please* don't send a message to one of the 
    718718public mailing lists. Django has a `policy for handling security issues`_; 
    719 while a defect is outstanding, we would like to minimize any damage that  
     719while a defect is outstanding, we would like to minimize any damage that 
    720720could be inflicted through public knowledge of that defect. 
    721721 
     
    743743functionality, and Django's developers have to review and prioritize. 
    744744 
    745 On top of that - the team working on Django are all volunteers. As a result,  
    746 the amount of time that we have to work on Django is limited, and will vary 
    747 from week to week depending on how much spare time we have. If we are busy, we 
    748 may not be able to spend as much time on Django as we might want. 
     745On top of that: the people who work on Django are all volunteers. As a result, 
     746the amount of time that we have to work on the framework is limited and will 
     747vary from week to week depending on our spare time. If we're busy, we may not 
     748be able to spend as much time on Django as we might want. 
    749749 
    750750Besides, if your feature request stands no chance of inclusion in Django, we 
  • django/trunk/docs/sessions.txt

    r7586 r7619  
    140140 
    141141            * If ``value`` is a ``datetime`` or ``timedelta`` object, the 
    142               session will expire at that specific time. 
    143        
    144             * If ``value`` is ``0`` then the user's session cookie will expire 
    145               when their browser is closed. 
     142              session will expire at that specific date/time. 
     143 
     144            * If ``value`` is ``0``, the user's session cookie will expire 
     145              when the user's Web browser is closed. 
    146146 
    147147            * If ``value`` is ``None``, the session reverts to using the global 
     
    169169 
    170170      Returns either ``True`` or ``False``, depending on whether the user's 
    171       session cookie will expire when their browser is closed. 
     171      session cookie will expire when the user's Web browser is closed. 
    172172 
    173173You can edit ``request.session`` at any point in your view. You can edit it 
  • django/trunk/docs/settings.txt

    r7538 r7619  
    394394DEBUG_PROPAGATE_EXCEPTIONS 
    395395-------------------------- 
     396 
     397**New in Django development version** 
    396398 
    397399Default: ``False``