lac avatar lac committed 17114b2

(lac, cfbolz) kill maemo, svn-help, obsolete parts of the coding guide and the development method

Comments (0)

Files changed (6)

pypy/doc/cleanup.rst

 
 .. doc-index: This needs merging somehow
 
-.. svn-help.rst: Needs merging/replacing with hg stuff:
-
-
 .. toctree::
 
    distribution.rst
 
-   rffi.rst
-
-   sandbox.rst
-
-   statistic/index.rst
-
-   docindex.rst
-
-   svn-help.rst
-
    dot-net.rst
 
-   maemo.rst
 
 
 

pypy/doc/coding-guide.rst

 
 .. contents::
 
-
-
 This document describes coding requirements and conventions for
 working with the PyPy code base.  Please read it carefully and
 ask back any questions you might have. The document does not talk
   branching/copying is a cheap operation with subversion, as it
   takes constant time irrespective of the size of the tree.
 
-- To learn more about how to use subversion read `this document`_.
-
-.. _`this document`: svn-help.html
-
-
-
 .. _`using development tracker`:
 
 Using the development bug/feature tracker

pypy/doc/dev_method.rst

 Main tools for achieving this is:
 
   * py.test - automated testing
-  * Subversion - version control
+  * Mercurial - version control
   * Transparent communication and documentation (mailinglists, IRC, tutorials
     etc etc) 
 
 interested in using sprints as away of making contact with active developers
 (Python/compiler design etc)!
 
-If you have questions about our sprints and EU-funding - please send an email
-to pypy-funding@codespeak.net, our mailinglist for project coordination.
-
-Previous sprints?
-+++++++++++++++++
-
-The PyPy team has been sprinting on the following occasions::
-
-    * Hildesheim                      Feb     2003
-    * Gothenburg                      May     2003
-    * Europython/Louvain-La-Neuve     June    2003
-    * Berlin                          Sept    2003
-    * Amsterdam                       Dec     2003
-    * Europython/Gothenburg           June    2004
-    * Vilnius                         Nov     2004
-    * Leysin                          Jan     2005
-    * PyCon/Washington                March   2005     
-    * Europython/Gothenburg           June    2005
-    * Hildesheim                      July    2005
-    * Heidelberg                      Aug     2005
-    * Paris                           Oct     2005
-    * Gothenburg                      Dec     2005
-    * Mallorca                        Jan     2006
-    * PyCon/Dallas                    Feb     2006
-    * Louvain-La-Neuve                March   2006
-    * Leysin                          April   2006
-    * Tokyo                           April   2006
-    * Düsseldorf                      June    2006
-    * Europython/Geneva               July    2006
-    * Limerick                        Aug     2006
-    * Düsseldorf                      Oct     2006
-    * Leysin                          Jan     2007
-    * Hildesheim                      Feb     2007
-    
-People who have participated and contributed during our sprints and thus
-contributing to PyPy (if we have missed someone here - please contact us 
-so we can correct it):
-
-    Armin Rigo
-    Holger Krekel
-    Samuele Pedroni
-    Christian Tismer
-    Laura Creighton
-    Jacob Hallén
-    Michael Hudson
-    Richard Emslie
-    Anders Chrigström
-    Alex Martelli
-    Ludovic Aubry
-    Adrien DiMascio
-    Nicholas Chauvat
-    Niklaus Haldimann
-    Anders Lehmann
-    Carl Friedrich Bolz
-    Eric Van Riet Paap
-    Stephan Diel
-    Dinu Gherman
-    Jens-Uwe Mager
-    Marcus Denker
-    Bert Freudenberg
-    Gunther Jantzen
-    Henrion Benjamin
-    Godefroid Chapelle
-    Anna Ravenscroft
-    Tomek Meka
-    Jonathan David Riehl
-    Patrick Maupain
-    Etienne Posthumus
-    Nicola Paolucci
-    Albertas Agejevas
-    Marius Gedminas
-    Jesus Cea Avion
-    Olivier Dormond
-    Jacek Generowicz
-    Brian Dorsey
-    Guido van Rossum
-    Bob Ippolito
-    Alan McIntyre
-    Lutz Paelike
-    Michael Chermside
-    Beatrice Düring
-    Boris Feigin
-    Amaury Forgeot d'Arc 
-    Andrew Thompson      
-    Valentino Volonghi   
-    Aurelien Campeas
-    Stephan Busemann
-    Johan Hahn
-    Gerald Klix
-    Gene Oden
-    Josh Gilbert
-    Geroge Paci
-    Martin Blais
-    Stuart Williams
-    Jiwon Seo
-    Michael Twomey 
-    Wanja Saatkamp
-    Alexandre Fayolle
-    Raphaël Collet
-    Grégoire Dooms
-    Sanghyeon Seo
-    Yutaka Niibe
-    Yusei Tahara
-    George Toshida
-    Koichi Sasada
-    Guido Wesdorp        
-    Maciej Fijalkowski   
-    Antonio Cuni          
-    Lawrence Oluyede    
-    Fabrizio Milo        
-    Alexander Schremmer  
-    David Douard       
-    Michele Frettoli     
-    Simon Burton         
-    Aaron Bingham        
-    Pieter Zieschang     
-    Sad Rejeb 
-    Brian Sutherland
-    Georg Brandl
-
-

pypy/doc/discussions.rst

 
 
 .. toctree::
+	
+	discussion/cli-optimizations.rst
+	discussion/distribution-implementation.rst
+	discussion/distribution-newattempt.rst
+	discussion/distribution-roadmap.rst
+	discussion/distribution.rst
+	discussion/finalizer-order.rst
+	discussion/howtoimplementpickling.rst
+	discussion/improve-rpython.rst
+	discussion/outline-external-ootype.rst
+	discussion/VM-integration.rst
 
-   discussion/GC-performance.rst
-   discussion/VM-integration.rst
-   discussion/chained_getattr.rst
-   discussion/cli-optimizations.rst
-   discussion/cmd-prompt-translation.rst
-   discussion/compiled-swamp.rst
-   discussion/ctypes_modules.rst
-   discussion/ctypes_todo.rst
-   discussion/distribution.rst
-   discussion/distribution-implementation.rst
-   discussion/distribution-newattempt.rst
-   discussion/distribution-roadmap.rst
-   discussion/emptying-the-malloc-zoo.rst
-   discussion/finalizer-order.rst
-   discussion/gc.rst
-   discussion/howtoimplementpickling.rst
-   discussion/improve-rpython.rst
-   discussion/outline-external-ootype.rst
-   discussion/oz-thread-api.rst
-   discussion/paper-wishlist.rst
-   discussion/parsing-ideas.rst
-   discussion/pypy_metaclasses_in_cl.rst
-   discussion/removing-stable-compiler.rst
-   discussion/security-ideas.rst
-   discussion/somepbc-refactoring-plan.rst
-   discussion/summer-of-pypy-pytest.rst
-   discussion/testing-zope.rst
-   discussion/thoughts_string_interning.rst
-   discussion/translation-swamp.rst
-   discussion/use_case_of_logic.rst
 

pypy/doc/maemo.rst

-How to run PyPy on top of maemo platform
-========================================
-
-This howto explains how to use Scratchbox_ to cross-compile PyPy's 
-Python Interpreter to an `Internet-Tablet-OS`_, more specifically 
-the Maemo_ platform.  This howto should work well for getting
-a usable Python Interpreter for Nokia's N810_ device. 
-
-setup cross-compilation environment
--------------------------------------
-
-The main steps are to install scratchbox and the Maemo SDK.  Please refer 
-to Nokia's `INSTALL.txt`_ for more detail. 
-
-Adjust linux kernel settings
-+++++++++++++++++++++++++++++++++
-
-In order to install and run scratchbox you will need to adjust
-your Linux kernel settings.  Note that the VDSO setting may
-crash your computer - if that is the case, try running without
-this setting. You can try it like this::
-
-   $ echo 4096 | sudo tee /proc/sys/vm/mmap_min_addr
-   $ echo 0 | sudo tee /proc/sys/vm/vdso_enabled 
-
-If that works fine for you (on some machines the vdso setting can freeze machines) 
-you can make the changes permanent by editing ``/etc/sysctl.conf`` to contain::
-
-    vm.vdso_enabled = 0
-    vm.mmap_min_addr = 4096
-
-install scratchbox packages
-+++++++++++++++++++++++++++++++++
-
-Download 
-
-	http://repository.maemo.org/stable/diablo/maemo-scratchbox-install_4.1.1.sh
-
-and run this script as root::
-
-  $ sh maemo-scratchbox-install_4.1.1.sh -s /scratchbox -u ACCOUNTNAME 
-
-The script will automatically download Debian packages or tarballs 
-and pre-configure a scratchbox environment with so called "devkits" 
-and "toolchains" for performing cross-compilation.  It's fine
-and recommended to use your linux account name as a scratchbox 
-ACCOUNTNAME. 
-
-It also sets up an "sbox" group on your system and makes you
-a member - giving the right to login to a scratchbox environment. 
-
-testing that scratchbox environment works
-+++++++++++++++++++++++++++++++++++++++++++++++
-
-Login freshly to your Linux account in order to activate 
-your membership in the "sbox" unix group and then type::
-
-  $ /scratchbox/login 
-
-This should warn you with something like "sb-conf: no current
-target" because we have not yet created a cross-compilation
-target.  
-
-Note that Scratchbox starts daemon services which 
-can be controlled via::
-
-    /scratchbox/sbin/sbox_ctl start|stop
-
-
-Installing the Maemo SDK 
-+++++++++++++++++++++++++++++++
-
-To mimic the specific N810_ environment we now install the Maemo-SDK.  
-This will create an target within our new scratchbox environment 
-that we then use to compile PyPy.  
-
-Make sure that you are a member of the "sbox" group - this might
-require logging out and in again. 
-
-Then, download 
-
-   http://repository.maemo.org/stable/diablo/maemo-sdk-install_4.1.1.sh
-
-and execute it with user privileges::
-
-   $ sh maemo-sdk-install_4.1.1.sh
-
-When being asked select the default "Runtime + Dev" packages.  You do not need 
-Closed source Nokia binaries for PyPy.  This installation
-script will download "rootstraps" and create so called
-"targets" and preselect the "DIABLO_ARMEL" target for ARM
-compilation.  Within the targets a large number of packages
-will be pre-installed resulting in a base scratchbox
-environment that is usable for cross compilation of PyPy.  
-
-Customizing the DIABLO_ARMEL target for PyPy
-++++++++++++++++++++++++++++++++++++++++++++++++
-
-As PyPy does not yet provide a debian package description
-file for use on Maemo, we have to install some dependencies manually
-into our Scratchbox target environment.  
-
-1. Go into your scratchbox by executing ``/scratchbox/login``
-   (this should bring you to a shell with the DIABLO_ARMEL target) 
-
-2. Add these lines to ``/etc/apt/sources.list``::
-
-    deb http://repository.maemo.org/extras/ diablo free non-free
-    deb http://repository.maemo.org/extras-devel/ diablo free non-free
-
-   NOTE: if you have an older version of Maemo on your device you 
-   can try substitute "chinook" for "diablo" in the above lines 
-   and/or update your firmware.  You can probably see which version
-   you are using by looking at the other content of the ``sources.list``. 
-
-3. Perform ``apt-get update``.
-
-4. Install some necessary packages::
-
-     apt-get install python2.5-dev libffi4-dev zlib1g-dev libbz2-dev libgc-dev libncurses5-dev 
-
-   The "libgc-dev" package is only needed if you want to use the Boehm
-   garbage collector. 
-
-5. Leave the scratchbox shell again with ``exit``. 
-
-
-Translating PyPy for the Maemo platform
-------------------------------------------
-
-You at least need "gcc" and "libc-dev" packages on your host system 
-to compile pypy.  The scratchbox and its DIABLO_ARMEL target contains 
-its own copies of GCC, various C libraries and header files
-which pypy needs for successful cross-compilation.  
-
-Now, on the host system, perform a subversion checkout of PyPy::
-
-    svn co https://codespeak.net/svn/pypy/trunk pypy-trunk
-
-Several svn revisions since the 60000's are known to work and
-the last manually tested one is currently 65011.  
-
-Change to the ``pypy-trunk/pypy/translator/goal`` directory and execute::
-
-    python translate.py --platform=maemo --opt=3
-
-You need to run translate.py using Python 2.5.  This will last some 30-60
-minutes on most machines.  For compiling the C source code PyPy's tool chain
-will use our scratchbox/Maemo cross-compilation environment. 
-
-When this step succeeds, your ``goal`` directory will contain a binary called
-``pypy-c`` which is executable on the Maemo device. To run this binary
-on your device you need to also copy some support files. A good way to 
-perform copies to your device is to install OpenSSH on the
-mobile device and use "scp" or rsync for transferring files.
-
-You can just copy your whole pypy-trunk directory over to your mobile 
-device - however, only these should be needed::
-
-    lib/pypy1.2/lib_pypy
-    lib/pypy1.2/lib-python
-    pypy/translator/goal/pypy-c
-
-It is necessary that the ``pypy-c`` can find a "lib-python" and "lib_pypy" directory
-if you want to successfully startup the interpreter on the device. 
-
-Start ``pypy-c`` on the device. If you see an error like "setupterm: could not find terminal" 
-you probably need to perform this install on the device::
-
-    apt-get install ncurses-base
-
-Eventually you should see something like::
-
-    Nokia-N810-51-3:~/pypy/trunk# ./pypy-c
-    Python Python 2.5.2 (pypy 1.0.0 build 59527) on linux2
-    Type "help", "copyright", "credits" or "license" for more information.
-    And now for something completely different: ``E09 2K @CAA:85?''
-    >>>> 
-
-    
-.. _N810: http://en.wikipedia.org/wiki/Nokia_N810
-.. _`Internet-Tablet-OS`: http://en.wikipedia.org/wiki/Internet_Tablet_OS
-.. _Maemo: http://www.maemo.org 
-.. _Scratchbox: http://www.scratchbox.org 
-.. _`INSTALL.txt`: http://tablets-dev.nokia.com/4.1/INSTALL.txt
-
-

pypy/doc/svn-help.rst

-
-Installing subversion for PyPy
-==============================
-
-Jens-Uwe Mager has prepared some installation files which should
-help you to install subversion on your computer.
-
-+ Download Unix source tarball or prepackaged versions_ for MacOS, Windows, FreeBSD and Linux
-
-+ Additional information for Windows users:
-
-  *  See Microsoft website_ if you have .DLL issues.
-
-  *  Windows Installer file for Tortoise SVN (like Tortoise CVS) GUI_
-     (Pick the UNICODE version for Windows 2000 and XP and
-     see Win_ 2000, NT if you have problems loading it.)
-
-+ Local copy of MacOS_ X binary tar ball
-  (This requires at least OS X 10.3)
-
-+ Debian instructions below...
-
-Getting started
------------------
-
-If you're just getting started with subversion, here's a simple how-to.
-For complete information, you can go read the subversion guide_.
-
-**Download and install the appropriate installation file of subversion above.**
-
-For linux:
-
-download the tarball.  unzip and untar it.  Then type *./configure*.  Then, as root, *make* followed by *make install*.  Voila ... a subversion client.
-
-For Debian users::
-
-  $ apt-get install subversion-tools
-
-People using Debian *stable* first need to add the following line to ``/etc/apt/sources.list`` (thanks backports_!)::
-
-  deb http://fs.cs.fhm.edu/mirror/backports.org/debian stable subversion
-
-Note that you can always go look at the files online_ with your browser, located at: http://codespeak.net/svn/pypy/trunk
-But, you'll want to check out your own local copies to work on.
-
-Check out and Check in
-----------------------------
-
-In order to get the sourcecode and docs downloaded onto your drive, open a shell or commandline and type::
-
-  $ svn co http://codespeak.net/svn/pypy/trunk
-
-If you are behind a dump proxy this may or may not work; see below.
-
-Once you've got the files checked out to your own system, you can use your favorite text editor to change to files. Be sure to read the coding-guide_ and other documentation files before doing a lot of work on the source code. Before doing any work, make sure you're using the most recent update with::
-
-  $ svn up
-
-this will update whichever subdirectory you're in (doc or src).
-
-When you're ready to **check in** a file,
-
-cd to your local checked out sourcecode directory, and if necessary, copy the file over from wherever you worked on it::
-
- $ cp ~/mydir/filename.ext filename.ext
-
-If you're adding a brand-new file::
-
-  $ svn add filename.ext
-
-Then, to **commit** it::
-
- $ svn ci -m "your comments about what changes your committing"
- $ your password: (this may not be necessary)
-
-You'll see something like the following::
-
- Adding         goals/stringcomp.py
- Transmitting file data .
- Committed revision 578.
-
-or::
-
- Sending        coding-guide.txt
- Transmitting file data .
- Committed revision 631.
-
-Check online on the `svn-commit archives`_ and you'll see your revision. Feel free to add a documentation file on any major changes you've made!
-
-.. _`svn-commit archives`: http://codespeak.net/pipermail/pypy-svn/
-
-Some other useful subversion tricks:
---------------------------------------
-
-**Be sure to remember ``svn`` in the commandline in the following commands.**
-
-``$ svn mv filename.ext``
-    to move or rename a file
-
-``$ svn rm filename.ext``
-    to remove (delete) a file
-
-``$ svn status``
-    will let you know what changes you've made compared to the current repository version
-
-``$ svn revert filename.ext``
-    will fix problems if you deleted or moved a file without telling svn.
-
-``$ svn cleanup``
-    last resort to fix it if you've got a totally messed up local copy.
-    Use this if you see error messages about ``locked`` files that you can't fix otherwise.
-
-Circumventing proxies
-----------------------------
-
-Some proxies don't let extended HTTP commands through.  If you have an
-error complaining about a bad request, you should use https: instead of
-http: in the subversion URL. This will make use of SSL encryption, which
-cannot be intercepted by proxies.
-
-Alternatively, if you want to change your proxy configuration, see the
-subversion FAQ: http://subversion.tigris.org/faq.html#proxy
-
-How to Avoid Line-ending Hell
------------------------------
-
-We will assume that whenever you create a .txt or a .py file, you would
-like other people to be able to read it with the line endings their
-OS prefers, even if that is different from the one your OS likes.  This
-could occasionally be wrong -- say when you are specifically testing
-that code you are writing handles line endings properly -- but this is
-what you want by default.  Binary files, on the other hand, should be
-stored exactly as is. This has to be set on every client. Here is how:
-
-In your home directory edit .subversion/config and comment in ::
-
-   [miscellany]
-   enable-auto-props = yes
-
-   [auto-props]
-   *.txt = svn:eol-style=native
-   *.py  = svn:eol-style=native
-
-
-.. _website: http://support.microsoft.com/default.aspx?scid=kb%3Ben-us%3B259403
-.. _GUI: http://tortoisesvn.tigris.org/servlets/ProjectDocumentList?folderID=616
-.. _MacOS: http://codespeak.net/~jum/svn-1.4.0-darwin-ppc.tar.gz
-.. _versions: http://subversion.tigris.org/project_packages.html
-.. _Win: http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=4B6140F9-2D36-4977-8FA1-6F8A0F5DCA8F
-.. _guide: http://svnbook.red-bean.com/book.html#svn-ch-1
-.. _backports: http://www.backports.org
-.. _online: http://codespeak.net/svn/pypy/trunk/
-.. _coding-guide: coding-guide.html
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.