On Mon, Jul 6, 2009 at 8:42 PM, Bill Hart<[email protected]> wrote:
>
> I've started writing some development documentation, which will take
> quite some time to complete. Here is what I have so far:
>
> http://sage.math.washington.edu/home/wbhart/mpir-development.pdf
* p-adic --> $p$-adic
* is not on software end users --> is not on software for end users
* " but on the needs of developers as users." -- what does that mean?
* "Finally, development of MPIR is focused largely on extreme performance. This
is of course the most fun component of working on MPIR, as other developers ..."
I think it would be pretty cool to include a plot of the mpirbench
score over the last few years on some architecture here. You could
emphasize that while clock speeds have stood essentially still during
the last 5 years, MPIR/GMP's speed has more than doubled.
* "Most extensive high level libraries which use MPIR routines
actually use the mpn layer," -- what does that mean? Is Sage or NTL
a "high level library"? It doesn't use mpn...
* "Windows and linux differ" -- capitalize Linux. (this problem is
all over in the doc)
* " 32 bit OSX" --> "32-bit OS X". In general, replace "OSX"
everywhere by "OS X".
* "than on linux, however a longstanding deficiency of MPIR" -- I
think it should be "linux; however,".
* "Arm" --> "ARM"
* "The mpz, mpq anf mpf layers" --> "The mpz, mpq and mpf layers"
* Your asterisked lists would look a lot better (I think) if you used
\begin{itemize}
\item the entry
...
\end{itemize}
* "type make check to run all these tests." --> "type {\tt make check}
to run all these tests."; same for "make tune" later, etc.
* "/doc/devel contains" --> "doc/devel contains"
* " on 32 bit X86 code " --> " on 32-bit x86 code "
* "build.vc9 - visual solutions files for MSVC " --> "build.vc9 -
Visual Studio solutions files for MSVC "
* "svn co http://modular.math.jmu.edu/svn/mpir/mpir/trunk mpir-trunk "
I own "mpir.org", so I could probably use proxying to make it so
"svn co http://svn.mpir.org/mpir/trunk mpir-trunk"
would work. Thoughts?
* I tried the above command and got the following:
"Last login: Tue Jul 7 16:31:04 on ttys004
You have new mail.
teragon:~ wstein$ cd tmp/
teragon:tmp wstein$ wget svn co
http://modular.math.jmu.edu/svn/mpir/mpir/trunk mpir-trunk
--17:04:21-- http://svn/
=> `index.html'
Resolving svn... 72.13.86.194
Connecting to svn|72.13.86.194|:80...
[hang for 10 minutes and I give up!!!!!]"
* <rant>
SVN sucks. It's the dark ages. It's sad on page 8 that you can't
just tell the developer --
(1) change files,
(2) check into to your local repo
(3) change more files, check in more changes
(4) When you're ready, post patches that any other developer can
just try out in their local repo.
You promised me you would watch Linus's talk here:
http://www.youtube.com/watch?v=4XpnKHJAok8
Please keep in mind that Linus is arguably the most successful person
ever at organizing and growing a large open source project.
</rant>
* "ammend" --> "amend"
Awesome! Please let me know when you post a new version with all the
new typos fixed.
William
>
> Here is the latex source in case anyone would like to add sections:
>
> http://sage.math.washington.edu/home/wbhart/mpir-development.tex
>
> Bill.
>
> >
>
--
William Stein
Associate Professor of Mathematics
University of Washington
http://wstein.org
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"mpir-devel" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to
[email protected]
For more options, visit this group at
http://groups.google.com/group/mpir-devel?hl=en
-~----------~----~----~----~------~----~------~--~---
