doc: remove misleading API documentation

The API is awkward, brittle, and frequently counterintuitive. Having it
documented sets an unrealistic expectation of it being a supported /
encouraged thing for developers outside the team to use. Until we have
an API we should stand behind, having it be undocumented is actually a
net win because people won't be misled into thinking they're gonna have
a good time by using it.

.gitignore

@@ -7,7 +7,6 @@ npm-debug.log
 /test/packages/test-package/random-data.txt
 /test/root
 /node_modules/.bin
-/html/api/
 /html/doc/
 /man/
 /doc/*/npm-index.md

Makefile

@@ -16,10 +16,6 @@ cli_mandocs = $(shell find doc/cli -name '*.md' \
                |sed 's|doc/cli/|man/man1/|g' ) \
                man/man1/npm-README.1
 
-api_mandocs = $(shell find doc/api -name '*.md' \
-               |sed 's|.md|.3|g' \
-               |sed 's|doc/api/|man/man3/|g' )
-
 files_mandocs = $(shell find doc/files -name '*.md' \
                |sed 's|.md|.5|g' \
                |sed 's|doc/files/|man/man5/|g' ) \
@@ -36,10 +32,6 @@ cli_htmldocs = $(shell find doc/cli -name '*.md' \
                 |sed 's|doc/cli/|html/doc/cli/|g' ) \
                 html/doc/README.html
 
-api_htmldocs = $(shell find doc/api -name '*.md' \
-                |sed 's|.md|.html|g' \
-                |sed 's|doc/api/|html/doc/api/|g' )
-
 files_htmldocs = $(shell find doc/files -name '*.md' \
                   |sed 's|.md|.html|g' \
                   |sed 's|doc/files/|html/doc/files/|g' ) \
@@ -51,9 +43,9 @@ misc_htmldocs = $(shell find doc/misc -name '*.md' \
                  |sed 's|doc/misc/|html/doc/misc/|g' ) \
                  html/doc/index.html
 
-mandocs = $(api_mandocs) $(cli_mandocs) $(files_mandocs) $(misc_mandocs)
+mandocs = $(cli_mandocs) $(files_mandocs) $(misc_mandocs)
 
-htmldocs = $(api_htmldocs) $(cli_htmldocs) $(files_htmldocs) $(misc_htmldocs)
+htmldocs = $(cli_htmldocs) $(files_htmldocs) $(misc_htmldocs)
 
 all: doc
 
@@ -93,7 +85,6 @@ doc-clean:
     .building_marked \
     .building_marked-man \
     html/doc \
-    html/api \
     man
 
 # use `npm install marked-man` for this to work.
@@ -105,10 +96,6 @@ man/man1/%.1: doc/cli/%.md scripts/doc-build.sh package.json
 	@[ -d man/man1 ] || mkdir -p man/man1
 	scripts/doc-build.sh $< $@
 
-man/man3/%.3: doc/api/%.md scripts/doc-build.sh package.json
-	@[ -d man/man3 ] || mkdir -p man/man3
-	scripts/doc-build.sh $< $@
-
 man/man5/npm-json.5: man/man5/package.json.5
 	cp $< $@
 
@@ -138,12 +125,9 @@ html/doc/cli/%.html: doc/cli/%.md $(html_docdeps)
 	@[ -d html/doc/cli ] || mkdir -p html/doc/cli
 	scripts/doc-build.sh $< $@
 
-html/doc/api/%.html: doc/api/%.md $(html_docdeps)
-	@[ -d html/doc/api ] || mkdir -p html/doc/api
-	scripts/doc-build.sh $< $@
-
 html/doc/files/npm-json.html: html/doc/files/package.json.html
 	cp $< $@
+
 html/doc/files/npm-global.html: html/doc/files/npm-folders.html
 	cp $< $@
 
@@ -168,7 +152,7 @@ node_modules/.bin/marked-man:
 
 doc: man
 
-man: $(cli_docs) $(api_docs)
+man: $(cli_docs)
 
 test: doc
 	node cli.js test