From 651284d0cea448553f1a25aef5bd1117b183d084 Mon Sep 17 00:00:00 2001
From: Brion Vibber <brion@users.mediawiki.org>
Date: Tue, 8 Feb 2011 23:45:16 +0000
Subject: [PATCH] * bug 27263: importDump.php now finally has --help text, also
 shown when stdin is a tty and no file given

---
 maintenance/importDump.php | 37 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 36 insertions(+), 1 deletion(-)

diff --git a/maintenance/importDump.php b/maintenance/importDump.php
index 5f47635eb6..e716640cd6 100644
--- a/maintenance/importDump.php
+++ b/maintenance/importDump.php
@@ -28,6 +28,7 @@ require_once( dirname( __FILE__ ) . '/commandLine.inc' );
 
 /**
  * @ingroup Maintenance
+ * @todo port to Maintenance class
  */
 class BackupReader {
 	var $reportingInterval = 100;
@@ -131,6 +132,10 @@ class BackupReader {
 
 	function importFromStdin() {
 		$file = fopen( 'php://stdin', 'rt' );
+		if( posix_isatty( $file ) ) {
+			$this->showHelp();
+			exit();
+		}
 		return $this->importFromHandle( $file );
 	}
 
@@ -155,6 +160,33 @@ class BackupReader {
 
 		return $importer->doImport();
 	}
+
+	function showHelp() {
+		$gz = in_array('compress.zlib', stream_get_wrappers()) ? 'ok' : '(disabled; requires PHP zlib module)';
+		$bz2 = in_array('compress.bzip2', stream_get_wrappers()) ? 'ok' : '(disabled; requires PHP bzip2 module)';
+		echo "This script reads pages from an XML file as produced from Special:Export\n";
+		echo "or dumpBackup.php, and saves them into the current wiki.\n";
+		echo "\n";
+		echo "Note that for very large data sets, importDump.php may be slow; there are\n";
+		echo "alternate methods which can be much faster for full site restoration:\n";
+		echo "http://www.mediawiki.org/wiki/Manual:Importing_XML_dumps\n";
+		echo "\n";
+		echo "Usage: php importDump.php [<options>] [<file>]\n";
+		echo "If no file is listed, input may be piped from stdin.\n";
+		echo "\n";
+		echo "Options:\n";
+		echo "  --quiet    Don't dump status reports to stderr.\n";
+		echo "  --report=n Report position and speed after every n pages processed.\n";
+		echo "  --dry-run  Parse dump without actually importing pages.\n";
+		echo "  --debug    Output extra verbose debug information\n";
+		echo "  --uploads  Process file upload data if included (experimental)\n";
+		echo "\n";
+		echo "Compressed XML files may be read directly:\n";
+		echo "  .gz $gz\n";
+		echo "  .bz2 $bz2\n";
+		echo "  .7z (if 7za executable is in PATH)\n";
+		echo "\n";
+	}
 }
 
 if ( wfReadOnly() ) {
@@ -178,7 +210,10 @@ if ( isset( $options['uploads'] ) ) {
 	$reader->uploads = true; // experimental!
 }
 
-if ( isset( $args[0] ) ) {
+if ( isset( $options['help'] ) ) {
+	$reader->showHelp();
+	exit();
+} elseif ( isset( $args[0] ) ) {
 	$result = $reader->importFromFile( $args[0] );
 } else {
 	$result = $reader->importFromStdin();
-- 
2.20.1