amp 0.5.2 → 0.5.3

data/.gitignore

@@ -1 +1,13 @@
+coverage*
 .hg/*
+ext/amp/*/*.bundle
+ext/amp/*/*.o
+ext/amp/*/Makefile
+test/localrepo_tests/testrepo/
+test/merge_tests/local.txt.out
+test/store_tests/store/
+doc/
+ext/amp/bz2/mkmf.log
+pkg/
+site/build/
+.yardoc

data/.hgignore

@@ -1,6 +1,8 @@
 syntax: glob
 .git/*
 doc/*
+coverage/*
+coverage.info
 .idea/*
 .yardoc
 test/store_tests/store/*
@@ -22,5 +24,6 @@ amp_serve_users.db
 pkg/*
 site/build/*
 site/src/doc*
+ext/amp/bz2/mkmf.log
 syntax: regexp
 \.DS_Store

data/AUTHORS

@@ -1,2 +1,2 @@
 Ari Brown
-Michael Edgar
+Michael Edgar

data/Manifest.txt

@@ -16,7 +16,6 @@ bin/amp1.9
 ext/amp/bz2/README.txt
 ext/amp/bz2/bz2.c
 ext/amp/bz2/extconf.rb
-ext/amp/bz2/mkmf.log
 ext/amp/mercurial_patch/extconf.rb
 ext/amp/mercurial_patch/mpatch.c
 ext/amp/priority_queue/extconf.rb
@@ -40,6 +39,7 @@ lib/amp/commands/commands/workflows/hg/add.rb
 lib/amp/commands/commands/workflows/hg/addremove.rb
 lib/amp/commands/commands/workflows/hg/annotate.rb
 lib/amp/commands/commands/workflows/hg/archive.rb
+lib/amp/commands/commands/workflows/hg/bisect.rb
 lib/amp/commands/commands/workflows/hg/branch.rb
 lib/amp/commands/commands/workflows/hg/branches.rb
 lib/amp/commands/commands/workflows/hg/bundle.rb
@@ -72,13 +72,43 @@ lib/amp/commands/commands/workflows/hg/status.rb
 lib/amp/commands/commands/workflows/hg/tag.rb
 lib/amp/commands/commands/workflows/hg/tags.rb
 lib/amp/commands/commands/workflows/hg/tip.rb
+lib/amp/commands/commands/workflows/hg/untrack.rb
 lib/amp/commands/commands/workflows/hg/update.rb
 lib/amp/commands/commands/workflows/hg/verify.rb
 lib/amp/commands/commands/workflows/hg/view.rb
+lib/amp/commands/commands/workflows/hg/what_changed.rb
 lib/amp/commands/dispatch.rb
 lib/amp/commands/hooks.rb
 lib/amp/dependencies/amp_support.rb
 lib/amp/dependencies/amp_support/ruby_amp_support.rb
+lib/amp/dependencies/maruku.rb
+lib/amp/dependencies/maruku/attributes.rb
+lib/amp/dependencies/maruku/defaults.rb
+lib/amp/dependencies/maruku/errors_management.rb
+lib/amp/dependencies/maruku/helpers.rb
+lib/amp/dependencies/maruku/input/charsource.rb
+lib/amp/dependencies/maruku/input/extensions.rb
+lib/amp/dependencies/maruku/input/html_helper.rb
+lib/amp/dependencies/maruku/input/linesource.rb
+lib/amp/dependencies/maruku/input/parse_block.rb
+lib/amp/dependencies/maruku/input/parse_doc.rb
+lib/amp/dependencies/maruku/input/parse_span_better.rb
+lib/amp/dependencies/maruku/input/rubypants.rb
+lib/amp/dependencies/maruku/input/type_detection.rb
+lib/amp/dependencies/maruku/input_textile2/t2_parser.rb
+lib/amp/dependencies/maruku/maruku.rb
+lib/amp/dependencies/maruku/output/to_ansi.rb
+lib/amp/dependencies/maruku/output/to_html.rb
+lib/amp/dependencies/maruku/output/to_markdown.rb
+lib/amp/dependencies/maruku/output/to_s.rb
+lib/amp/dependencies/maruku/string_utils.rb
+lib/amp/dependencies/maruku/structures.rb
+lib/amp/dependencies/maruku/structures_inspect.rb
+lib/amp/dependencies/maruku/structures_iterators.rb
+lib/amp/dependencies/maruku/textile2.rb
+lib/amp/dependencies/maruku/toc.rb
+lib/amp/dependencies/maruku/usage/example1.rb
+lib/amp/dependencies/maruku/version.rb
 lib/amp/dependencies/minitar.rb
 lib/amp/dependencies/priority_queue.rb
 lib/amp/dependencies/priority_queue/c_priority_queue.rb
@@ -95,41 +125,63 @@ lib/amp/dependencies/zip/ziprequire.rb
 lib/amp/encoding/base85.rb
 lib/amp/encoding/binary_diff.rb
 lib/amp/encoding/difflib.rb
-lib/amp/encoding/mercurial_diff.rb
-lib/amp/encoding/mercurial_patch.rb
-lib/amp/encoding/patch.rb
-lib/amp/encoding/pure_ruby/ruby_mercurial_patch.rb
 lib/amp/extensions/ditz.rb
 lib/amp/extensions/lighthouse.rb
 lib/amp/graphs/ancestor.rb
 lib/amp/graphs/copies.rb
-lib/amp/merges/merge_state.rb
-lib/amp/merges/merge_ui.rb
-lib/amp/merges/simple_merge.rb
+lib/amp/help/entries/__default__.erb
+lib/amp/help/entries/commands.erb
+lib/amp/help/entries/mdtest.md
+lib/amp/help/entries/silly
+lib/amp/help/help.rb
 lib/amp/profiling_hacks.rb
-lib/amp/repository/branch_manager.rb
-lib/amp/repository/dir_state.rb
-lib/amp/repository/journal.rb
-lib/amp/repository/lock.rb
-lib/amp/repository/repositories/bundle_repository.rb
-lib/amp/repository/repositories/http_repository.rb
-lib/amp/repository/repositories/local_repository.rb
+lib/amp/repository/abstract/abstract_changeset.rb
+lib/amp/repository/abstract/abstract_local_repo.rb
+lib/amp/repository/abstract/abstract_staging_area.rb
+lib/amp/repository/abstract/abstract_versioned_file.rb
+lib/amp/repository/abstract/common_methods/changeset.rb
+lib/amp/repository/abstract/common_methods/local_repo.rb
+lib/amp/repository/abstract/common_methods/staging_area.rb
+lib/amp/repository/abstract/common_methods/versioned_file.rb
+lib/amp/repository/generic_repo_picker.rb
+lib/amp/repository/git/repo_format/changeset.rb
+lib/amp/repository/git/repo_format/staging_area.rb
+lib/amp/repository/git/repo_format/versioned_file.rb
+lib/amp/repository/git/repositories/local_repository.rb
+lib/amp/repository/git/repository.rb
+lib/amp/repository/mercurial/encoding/mercurial_diff.rb
+lib/amp/repository/mercurial/encoding/mercurial_patch.rb
+lib/amp/repository/mercurial/encoding/patch.rb
+lib/amp/repository/mercurial/encoding/pure_ruby/ruby_mercurial_patch.rb
+lib/amp/repository/mercurial/merging/merge_ui.rb
+lib/amp/repository/mercurial/merging/simple_merge.rb
+lib/amp/repository/mercurial/repo_format/branch_manager.rb
+lib/amp/repository/mercurial/repo_format/changeset.rb
+lib/amp/repository/mercurial/repo_format/dir_state.rb
+lib/amp/repository/mercurial/repo_format/journal.rb
+lib/amp/repository/mercurial/repo_format/lock.rb
+lib/amp/repository/mercurial/repo_format/merge_state.rb
+lib/amp/repository/mercurial/repo_format/staging_area.rb
+lib/amp/repository/mercurial/repo_format/store.rb
+lib/amp/repository/mercurial/repo_format/tag_manager.rb
+lib/amp/repository/mercurial/repo_format/updatable.rb
+lib/amp/repository/mercurial/repo_format/updater.rb
+lib/amp/repository/mercurial/repo_format/verification.rb
+lib/amp/repository/mercurial/repositories/bundle_repository.rb
+lib/amp/repository/mercurial/repositories/http_repository.rb
+lib/amp/repository/mercurial/repositories/local_repository.rb
+lib/amp/repository/mercurial/repository.rb
+lib/amp/repository/mercurial/revlogs/bundle_revlogs.rb
+lib/amp/repository/mercurial/revlogs/changegroup.rb
+lib/amp/repository/mercurial/revlogs/changelog.rb
+lib/amp/repository/mercurial/revlogs/file_log.rb
+lib/amp/repository/mercurial/revlogs/index.rb
+lib/amp/repository/mercurial/revlogs/manifest.rb
+lib/amp/repository/mercurial/revlogs/node.rb
+lib/amp/repository/mercurial/revlogs/revlog.rb
+lib/amp/repository/mercurial/revlogs/revlog_support.rb
+lib/amp/repository/mercurial/revlogs/versioned_file.rb
 lib/amp/repository/repository.rb
-lib/amp/repository/store.rb
-lib/amp/repository/tag_manager.rb
-lib/amp/repository/updatable.rb
-lib/amp/repository/verification.rb
-lib/amp/repository/versioned_file.rb
-lib/amp/revlogs/bundle_revlogs.rb
-lib/amp/revlogs/changegroup.rb
-lib/amp/revlogs/changelog.rb
-lib/amp/revlogs/changeset.rb
-lib/amp/revlogs/file_log.rb
-lib/amp/revlogs/index.rb
-lib/amp/revlogs/manifest.rb
-lib/amp/revlogs/node.rb
-lib/amp/revlogs/revlog.rb
-lib/amp/revlogs/revlog_support.rb
 lib/amp/server/amp_user.rb
 lib/amp/server/extension/amp_extension.rb
 lib/amp/server/extension/authorization.rb
@@ -151,20 +203,20 @@ lib/amp/support/amp_config.rb
 lib/amp/support/amp_ui.rb
 lib/amp/support/docs.rb
 lib/amp/support/generator.rb
-lib/amp/support/ignore.rb
 lib/amp/support/loaders.rb
 lib/amp/support/logger.rb
 lib/amp/support/match.rb
+lib/amp/support/mercurial/ignore.rb
 lib/amp/support/multi_io.rb
 lib/amp/support/openers.rb
 lib/amp/support/ruby_19_compatibility.rb
 lib/amp/support/support.rb
-lib/amp/templates/blank.commit.erb
-lib/amp/templates/blank.log.erb
-lib/amp/templates/default.commit.erb
-lib/amp/templates/default.log.erb
+lib/amp/templates/mercurial/blank.commit.erb
+lib/amp/templates/mercurial/blank.log.erb
+lib/amp/templates/mercurial/default.commit.erb
+lib/amp/templates/mercurial/default.log.erb
 lib/amp/templates/template.rb
-site/Rakefile
+man/amp.1
 site/src/about/ampfile.haml
 site/src/about/commands.haml
 site/src/about/index.haml
@@ -211,11 +263,13 @@ site/src/index.haml
 site/src/learn/index.haml
 site/src/scripts/jquery-1.3.2.min.js
 site/src/scripts/jquery.cookie.js
+tasks/man.rake
 tasks/stats.rake
 tasks/yard.rake
 test/dirstate_tests/dirstate
 test/dirstate_tests/hgrc
 test/dirstate_tests/test_dir_state.rb
+test/functional_tests/annotate.out
 test/functional_tests/resources/.hgignore
 test/functional_tests/resources/STYLE.txt
 test/functional_tests/resources/command.rb
@@ -265,6 +319,7 @@ test/functional_tests/resources/version5_2/commands/newz.rb
 test/functional_tests/resources/version5_2/commands/stats.rb
 test/functional_tests/resources/version5_2/commands/status.rb
 test/functional_tests/test_functional.rb
+test/localrepo_tests/ampfile.rb
 test/localrepo_tests/test_local_repo.rb
 test/localrepo_tests/testrepo.tar.gz
 test/manifest_tests/00manifest.i
@@ -281,14 +336,20 @@ test/revlog_tests/test_revlog.rb
 test/revlog_tests/testindex.i
 test/store_tests/store.tar.gz
 test/store_tests/test_fncache_store.rb
-test/test_amp.rb
+test/test_19_compatibility.rb
 test/test_base85.rb
 test/test_bdiff.rb
+test/test_changegroup.rb
 test/test_commands.rb
 test/test_difflib.rb
-test/test_helper.rb
+test/test_generator.rb
+test/test_ignore.rb
 test/test_journal.rb
 test/test_match.rb
 test/test_mdiff.rb
 test/test_mpatch.rb
+test/test_multi_io.rb
 test/test_support.rb
+test/test_templates.rb
+test/test_ui.rb
+test/testutilities.rb

data/README.md

@@ -1,4 +1,4 @@
-Amp Release v0.5.1 (John Locke)
+Amp Release v0.5.3 (John Locke)
 ==============================
 
 **Homepage**:   [http://amp.carboni.ca](http://amp.carboni.ca)   
@@ -6,7 +6,7 @@ Amp Release v0.5.1 (John Locke)
 **Git**:        [http://github.com/michaeledgar/amp](http://github.com/michaeledgar/amp)   
 **Mercurial**:  [http://bitbucket.org/carbonica/amp](http://bitbucket.org/carbonica/amp)   
 **Author**:     Michael Edgar & Ari Brown  
-**Copyright**:  2009  
+**Copyright**:  2009-2010
 **License**:    GPLv2 (inherited from Mercurial)  
 
 
@@ -74,7 +74,7 @@ ________
     % amp commit -m "leethaxness"
     % amp push
   
-Nothing really changes from using the hg command. There are a few differences
+Nothing really changes from using the hg/git command. There are a few differences
 here and there (see `amp help [COMMAND]`), but really, it's pretty much the same.
   
 Using amp as a library:

data/Rakefile

@@ -1,6 +1,5 @@
 # -*- ruby -*-
 
-require 'rubygems'
 require 'rake'
 require 'rake/tasklib'
 require 'rake/testtask'
@@ -21,18 +20,18 @@ def remove_task(*task_names)
   end
 end
  
-
+Hoe.plugin :minitest
 Hoe.spec "amp" do
   developer "Michael Edgar", "adgar@carboni.ca"
   developer "Ari Brown", "seydar@carboni.ca"
   self.url = "http://amp.carboni.ca/"
   self.spec_extras = {:extensions => ["ext/amp/mercurial_patch/extconf.rb",
-                                      "ext/amp/priority_queue/extconf.rb",
-                                      "ext/amp/support/extconf.rb",
-                                      "ext/amp/bz2/extconf.rb"]}
+                                 "ext/amp/priority_queue/extconf.rb",
+                                 "ext/amp/support/extconf.rb",
+                                 "ext/amp/bz2/extconf.rb"]}
   self.need_rdoc = false
-  self.flog_threshold = 50000
   self.summary = "Version Control in Ruby. Mercurial Compatible. Big Ideas."
+  extra_dev_deps << ["rtfm", ">= 0.5.1"] << ["yard", ">= 0.4.0"] << ["minitest", ">= 1.5.0"]
 end
  
 # Hoe.spec "amp-pure" do
@@ -48,10 +47,11 @@ end
 
 
 remove_task 'test_deps', 'publish_docs', 'post_blog', 
-            'deps:fetch', 'deps:list', 'deps:email', 'flay', 'clean', 'test'
+            'deps:fetch', 'deps:list', 'deps:email', 'flay', 'clean', 'flog'
 
 load 'tasks/yard.rake'
 load 'tasks/stats.rake'
+load 'tasks/man.rake'
 
 desc "Build the C extensions"
 task :build do
@@ -85,18 +85,53 @@ task :prepare do
 end
 
 # liberally modified from Hoe's
-desc 'Test the amp AWESOMENESS.'
-task :test do
-  framework = "test/unit"
-  test_globs = ['test/**/test_*.rb']
-  ruby_flags = ENV['RUBY_FLAGS'] || "-w -I#{%w(lib ext bin test).join(File::PATH_SEPARATOR)}" +
-    (ENV['RUBY_DEBUG'] ? " #{ENV['RUBY_DEBUG']}" : '')
-  tests = [ framework] +
-    test_globs.map { |g| Dir.glob(g) }.flatten
-  tests.map! {|f| %(require "#{f}")}
-  cmd = "#{ruby_flags} -e '$amp_testing = true; #{tests.join("; ")}' "
+# desc 'Test the amp AWESOMENESS.'
+# task :test do
+#   framework = "test/unit"
+#   test_globs = ['test/**/test_*.rb']
+#   ruby_flags = ENV['RUBY_FLAGS'] || "-w -I#{%w(lib ext bin test).join(File::PATH_SEPARATOR)}" +
+#     (ENV['RUBY_DEBUG'] ? " #{ENV['RUBY_DEBUG']}" : '')
+#   tests = [ framework] +
+#     test_globs.map { |g| Dir.glob(g) }.flatten
+#   tests.map! {|f| %(require "#{f}")}
+#   cmd = "#{ruby_flags} -e '$amp_testing = true; #{tests.join("; ")}' "
+#   
+#   ruby cmd
+# end
+
+desc "Compile Site"
+task :"build-website" do
+  require 'site/src/helpers.rb'
+  load 'lib/amp.rb' # get the version
+  missing_gems = []
+  requirements = ['haml', 'uv']
+  requirements_install = ['haml', 'ultraviolet']
+  requirements.each do |requirement|
+    begin
+      require requirement
+    rescue LoadError => e
+      puts "The following gems are required to build the amp website: #{requirements.join(", ")}"
+      puts "Install them as follows: gem install #{requirements_install.join(" ")}"
+      puts "You will need oniguruma. Here's a helpful explanation of how to install it if"
+      puts "you need some help: http://snippets.aktagon.com/snippets/61-Installing-Ultraviolet-and-Onigurama"
+      exit
+    end
+  end
   
-  ruby cmd
+  Dir["site/src/**/*.haml"].reject {|item| item.split("/").last =~ /^_/}.each do |haml|
+    file_path = haml[8..-6]
+    FileUtils.makedirs(File.dirname("site/build" + file_path + ".html"))
+    File.open("site/build" + file_path + ".html","w") do |out|
+      puts "Building #{file_path}"
+      out.write render(haml)
+    end
+  end
+  %w(css images scripts docs).each do |dir|
+    src = "site/src/#{dir}/"
+    if File.exist? src
+      sh "cp -r #{src} site/build/#{dir}/"
+    end
+  end
 end
 
 # vim: syntax=Ruby

data/SCHEDULE.markdown

@@ -9,4 +9,8 @@ release happens, use the next name on the list.
 - √ Charles Hieronymus Pace
 - John Locke
 - Christian Shephard
-- The Smoke Monster
+- The Smoke Monster
+- Suomen
+- The word representing how some languages don't distinguish between blue and green
+- Magyar
+- Eagle Scout

data/TODO.markdown

@@ -1,149 +1,120 @@
-Amp::Patch::Patch
-=================
-
-Amp::Patch::Patch#hash\_lines
------------------------------
-  - 
-
-Amp::Patch::Patch#hash=
------------------------
-  - 
-
-Amp::Patch::Patch#find\_lines
------------------------------
-  - 
-
-Amp::Patch::Patch#hash
-----------------------
-  - 
-
-Amp::Patch::Patch#hunks=
-------------------------
-  - 
-
-Amp::Patch::Patch#hunks
------------------------
-  - 
-
-Amp::Patch::Patch#offset=
--------------------------
-  - 
-
-Amp::Patch::Patch#lines=
-------------------------
-  - 
-
-Amp::Patch::Patch#offset
-------------------------
-  - 
-
-Amp::Patch::Patch#lines
------------------------
-  - 
-
-
-Amp::Support::Template
-======================
-
-Amp::Support::Template#render
------------------------------
-  - 
-
-
-Amp::Repositories::HTTPRepository
-=================================
-
-Amp::Repositories::HTTPRepository#changegroup
----------------------------------------------
-  - 
-
-
-Amp::RevlogSupport::IndexInlineNG
-=================================
-
-Amp::RevlogSupport::IndexInlineNG#parse\_file
----------------------------------------------
-  - 
-
-
-File
-====
-
-File.amp\_find\_executable
---------------------------
-  - 
-
-File.amp\_set\_executable
--------------------------
-  - 
-
-File.amp\_lookup\_reg
----------------------
-  - 
-
-
-Amp::Revlog
-===========
-
-Amp::Revlog#check\_inline\_size
--------------------------------
-  - 
-  - 
-
-
-Amp::ChangeLog
-==============
-
-Amp::ChangeLog#add
-------------------
-  - 
-
-Amp::ChangeLog#read
--------------------
-  - 
-
-
-Amp::Repositories::DirState
-===========================
-
-Amp::Repositories::DirState#normalize
--------------------------------------
-  - 
-
-Amp::Repositories::DirState#write
----------------------------------
-  - 
-
-
-Amp::Repositories::LocalRepository
-==================================
-
-Amp::Repositories::LocalRepository#push\_add\_changegroup
----------------------------------------------------------
-  - 
-
-Amp::Repositories::LocalRepository#push\_unbundle
--------------------------------------------------
-  - 
-
-Amp::Repositories::Updatable#update
------------------------------------
-  - 
-
-Amp::Repositories::LocalRepository#changegroup\_info
-----------------------------------------------------
-  - 
-
-Amp::Repositories::TagManager#read\_tags
-----------------------------------------
-  - 
-
-Amp::Repositories::Updatable#apply\_updates
--------------------------------------------
-  - 
-
-Amp::Repositories::LocalRepository#pre\_push
---------------------------------------------
-  - 
-
-
+Here are the things we'd like to do. If you're looking to help out, read on.
+We have put them into several categories to trick^H^H^H^H^Hencourage you into
+helping.
+
+**RULE NUMBER 1**: It's ok if you break amp. Go ahead and accidentally remove
+every file, commit, and then push it. We're not worried; we have immutable history
+and multiple copies of the repo and advanced knowledge of `amp/hg revert`. You
+can't hurt us.
+
+== Specifics
+
+= Amp config
+Write now we save config information is ~/.hgrc. Somebody, please, either
+drown me or make this go the fuck away. Config information could (should?)
+be saved in the top section of the ampfile. It can be a YAML object serialized
+with comments prefixing each line, with the entire section ending with a series
+of #s.
+
+= Remote Repositories
+They. All. Look. The. Same. At least as far as amp is concerned, at them moment.
+We need to fix this shiznizzle because this means you cannot use a foreign
+repository for anything other than Mercurial, really (based on how the files
+are loaded). Be creative. Be awesome. Be daring. Few in millions can speak like us.
+Show the world why you are a programmer. SOLVE THIS PROBLEM!
+
+== Maintenance
+
+= Dependencies
+We need these down to zero. Currently we DO need YARD, but flay and flog? We
+haven't used these at all yet. Either remove these from the code (well, really
+the Rakefiles) or add a way to fail gracefully. We also now need minitest, etc.
+Development dependencies are ok, but dependencies for running? Kill them. Kill
+them aaaaaaalllllllllllll.
+
+= Multitude of Tests
+Tests. We need them. Moar and moar of them. We want every command to be tested
+(at least generally), although if every option were also tested that'd be
+superb.
+
+= Organization of Tests
+We currently have a gigantic test_functional.rb file that has most of the good
+tests. However, if there's a failure in the very beginning, the rest of the
+tests won't be run. It's true – some of the tests are dependent on each other,
+but perjaps there's a way to split them up into clusters that make sense and
+can be run independently.
+
+= Code Cleaning
+We have ugly code. We try to mark it with comments, we try to eliminate it in
+the first place, but seriously, when it comes to programming or doing some
+World Religions homework, I'm going to get the homework done first. And then
+some girl will have IMed me, and, well, you get the point. If you see ugly
+code, kill it. Hopefully it won't require any major architectural changes.
+
+= API Adherence
+Make the commands in the workflows stick to the API. If something doesn't adhere,
+change the API and change the command until it works. **NOTU BONE (Esperanto)**:
+Write a plethora of tests before changing a command, lest you break some
+little-known feature of the command and in its stead add a new "feature".
+
+== Expansion
+
+= Faster Bit Structs
+We experimented with using bitstructs to represent objects in files. Although
+this worked, it was MUCH slower than we could bare. We need a faster form of
+a bitstruct. A bitstruct is a standard C struct. If has a format, it has fields
+with names, and you can easily read and write them to and from files. Writing
+this alone is a task big enough for a young adult. We need these tested and
+benchmarked against not using bitstructs. Also, try to keep these pure ruby if
+you can.
+
+= Incorporating Bit Structs
+Take the bitstructs of the previous paragraph and incorporate them into
+everything. If you can, fix up the mercurial revlog API to make it suck a
+little less.
+
+= hg Extensions
+Start porting over the Mercurial extensions. 'Nuff said.
+
+= Expanding `amp serve`
+We'd like it to be more like BitBucket and GitHub. Go crazy. One thing you
+could do is implement other methods for storing users besides memory. There
+are incomplete frameworks for Sequel and DataMapper storage that need TLC.
+
+== Help
+
+= Pages of info
+We need to have specific pages explaining amp-specific features, and helping
+users get started using amp. Anything put into lib/amp/help/entries will be
+loaded with its filename as the help entry's name. So, if you create a file
+called "ampfiles.md", then "amp help ampfiles" will present the file you created.
+
+== Insects (low-low-low-priority bugs)
+
+= Test Reloading
+Files get double-loaded when we run tests. Fix this. Kill the fucking insect.
+
+== Documentation
+
+= User guide
+We need a guide that will tell new users how to install and use amp. It should
+explain what to do if you get a bug. Add this into the help system so it can be
+CLI-accessible and browser-accessible. Add it to the man pages as well (see
+tasks/man.rake).
+
+= Inline documentation
+Go through to big ugly methods (or any method, no matter how dumb) and add
+inline comments explaining what the method does and HOW IT INTERACTS WITH
+THE REST OF THE SYSTEM. Comments should be formatted according to YARD
+documentation format (http://yardoc.org). Key questions to ask and answer:
+Who (uses this), What (is passed in), Why (this exists), and How (this
+interacts with the rest of the system).
+
+= Wiki
+We need to expand out BitBucket wiki so that it is more appeasing and useful.
+
+== Optimization
+
+= StagingArea#file_status
+This is called like a million times and it's unnecessary. We can use memoization
+alleviate any pains. But be apprised: we have yet to feel any pains from it.