From 74d034cf3607c2063bd3176e3a46802594038b40 Mon Sep 17 00:00:00 2001 From: Andrew Bayer Date: Fri, 22 Jul 2011 20:03:55 +0000 Subject: [PATCH] Fix documentation format for use with asciidoc 8.5. Comment blocks (for the license header) must appear at the end of a man page asciidoc file; they cannot appear near the top. From: Aaron Kimball git-svn-id: https://svn.apache.org/repos/asf/incubator/sqoop/trunk@1149910 13f79535-47bb-0310-9956-ffa450edef68 --- src/docs/man/sqoop-codegen.txt | 35 ++++++++++++------------ src/docs/man/sqoop-create-hive-table.txt | 35 ++++++++++++------------ src/docs/man/sqoop-eval.txt | 35 ++++++++++++------------ src/docs/man/sqoop-export.txt | 35 ++++++++++++------------ src/docs/man/sqoop-help.txt | 34 +++++++++++------------ src/docs/man/sqoop-import-all-tables.txt | 34 +++++++++++------------ src/docs/man/sqoop-import.txt | 34 +++++++++++------------ src/docs/man/sqoop-list-databases.txt | 34 +++++++++++------------ src/docs/man/sqoop-list-tables.txt | 34 +++++++++++------------ src/docs/man/sqoop-version.txt | 32 +++++++++++----------- src/docs/man/sqoop.txt | 34 +++++++++++------------ 11 files changed, 190 insertions(+), 186 deletions(-) diff --git a/src/docs/man/sqoop-codegen.txt b/src/docs/man/sqoop-codegen.txt index b4fc0252..d74e6280 100644 --- a/src/docs/man/sqoop-codegen.txt +++ b/src/docs/man/sqoop-codegen.txt @@ -1,23 +1,6 @@ sqoop-codegen(1) ================ -//// - Licensed to Cloudera, Inc. under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. -//// - NAME ---- sqoop-codegen - Generates wrapper classes to store and parse database records. @@ -74,3 +57,21 @@ ENVIRONMENT See 'sqoop(1)' + +//// + Licensed to Cloudera, Inc. under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +//// + diff --git a/src/docs/man/sqoop-create-hive-table.txt b/src/docs/man/sqoop-create-hive-table.txt index 796fe4da..39fbea92 100644 --- a/src/docs/man/sqoop-create-hive-table.txt +++ b/src/docs/man/sqoop-create-hive-table.txt @@ -1,23 +1,6 @@ sqoop-create-hive-table(1) ========================== -//// - Licensed to Cloudera, Inc. under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. -//// - NAME ---- sqoop-create-hive-table - Create a Hive table definition based on a @@ -66,3 +49,21 @@ ENVIRONMENT See 'sqoop(1)' + +//// + Licensed to Cloudera, Inc. under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +//// + diff --git a/src/docs/man/sqoop-eval.txt b/src/docs/man/sqoop-eval.txt index 907624bb..fcc03103 100644 --- a/src/docs/man/sqoop-eval.txt +++ b/src/docs/man/sqoop-eval.txt @@ -1,23 +1,6 @@ sqoop-eval(1) ============= -//// - Licensed to Cloudera, Inc. under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. -//// - NAME ---- sqoop-eval - Evalute a SQL query and display its results @@ -54,3 +37,21 @@ ENVIRONMENT See 'sqoop(1)' + +//// + Licensed to Cloudera, Inc. under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +//// + diff --git a/src/docs/man/sqoop-export.txt b/src/docs/man/sqoop-export.txt index 6fee09c6..c7c76b4f 100644 --- a/src/docs/man/sqoop-export.txt +++ b/src/docs/man/sqoop-export.txt @@ -1,23 +1,6 @@ sqoop-export(1) =============== -//// - Licensed to Cloudera, Inc. under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. -//// - NAME ---- sqoop-export - Export records from HDFS to a table in an RDBMS @@ -77,3 +60,21 @@ ENVIRONMENT See 'sqoop(1)' + +//// + Licensed to Cloudera, Inc. under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +//// + diff --git a/src/docs/man/sqoop-help.txt b/src/docs/man/sqoop-help.txt index 75e31896..ec30dcaa 100644 --- a/src/docs/man/sqoop-help.txt +++ b/src/docs/man/sqoop-help.txt @@ -1,23 +1,6 @@ sqoop-help(1) ============= -//// - Licensed to Cloudera, Inc. under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. -//// - NAME ---- sqoop-help - List available tools and display usage information @@ -40,3 +23,20 @@ OPTIONS With no arguments, displays the list of available tools. With an optional tool name specified, displays the usage for that particular tool. +//// + Licensed to Cloudera, Inc. under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +//// + diff --git a/src/docs/man/sqoop-import-all-tables.txt b/src/docs/man/sqoop-import-all-tables.txt index 17802ee7..a9722708 100644 --- a/src/docs/man/sqoop-import-all-tables.txt +++ b/src/docs/man/sqoop-import-all-tables.txt @@ -1,23 +1,6 @@ sqoop-import-all-tables(1) ========================== -//// - Licensed to Cloudera, Inc. under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. -//// - NAME ---- sqoop-import-all-tables - Import a set of table from an RDBMS to HDFS @@ -112,3 +95,20 @@ ENVIRONMENT See 'sqoop(1)' +//// + Licensed to Cloudera, Inc. under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +//// + diff --git a/src/docs/man/sqoop-import.txt b/src/docs/man/sqoop-import.txt index 73373096..cf33b990 100644 --- a/src/docs/man/sqoop-import.txt +++ b/src/docs/man/sqoop-import.txt @@ -1,23 +1,6 @@ sqoop-import(1) =============== -//// - Licensed to Cloudera, Inc. under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. -//// - NAME ---- sqoop-import - Import a table from an RDBMS to HDFS @@ -106,3 +89,20 @@ ENVIRONMENT See 'sqoop(1)' +//// + Licensed to Cloudera, Inc. under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +//// + diff --git a/src/docs/man/sqoop-list-databases.txt b/src/docs/man/sqoop-list-databases.txt index a654cfa9..09e0fe1c 100644 --- a/src/docs/man/sqoop-list-databases.txt +++ b/src/docs/man/sqoop-list-databases.txt @@ -1,23 +1,6 @@ sqoop-list-databases(1) ======================= -//// - Licensed to Cloudera, Inc. under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. -//// - NAME ---- sqoop-list-databases - List databases available on a server. @@ -51,3 +34,20 @@ ENVIRONMENT See 'sqoop(1)' +//// + Licensed to Cloudera, Inc. under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +//// + diff --git a/src/docs/man/sqoop-list-tables.txt b/src/docs/man/sqoop-list-tables.txt index a234a7a0..27c23817 100644 --- a/src/docs/man/sqoop-list-tables.txt +++ b/src/docs/man/sqoop-list-tables.txt @@ -1,23 +1,6 @@ sqoop-list-tables(1) ==================== -//// - Licensed to Cloudera, Inc. under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. -//// - NAME ---- sqoop-list-tables - List tables available for import in a database. @@ -47,3 +30,20 @@ ENVIRONMENT See 'sqoop(1)' +//// + Licensed to Cloudera, Inc. under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +//// + diff --git a/src/docs/man/sqoop-version.txt b/src/docs/man/sqoop-version.txt index 8c1f8c91..0ca2b74e 100644 --- a/src/docs/man/sqoop-version.txt +++ b/src/docs/man/sqoop-version.txt @@ -1,6 +1,22 @@ sqoop-version(1) ================ +NAME +---- +sqoop-version - Display version information for Sqoop. + +SYNOPSIS +-------- +'sqoop-version' + +'sqoop version' + + +DESCRIPTION +----------- + +Display version information. + //// Licensed to Cloudera, Inc. under one or more contributor license agreements. See the NOTICE file distributed with @@ -18,19 +34,3 @@ sqoop-version(1) limitations under the License. //// -NAME ----- -sqoop-version - Display version information for Sqoop. - -SYNOPSIS --------- -'sqoop-version' - -'sqoop version' - - -DESCRIPTION ------------ - -Display version information. - diff --git a/src/docs/man/sqoop.txt b/src/docs/man/sqoop.txt index 80aa2357..7200e546 100644 --- a/src/docs/man/sqoop.txt +++ b/src/docs/man/sqoop.txt @@ -1,23 +1,6 @@ sqoop(1) ======== -//// - Licensed to Cloudera, Inc. under one or more - contributor license agreements. See the NOTICE file distributed with - this work for additional information regarding copyright ownership. - Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 - (the "License"); you may not use this file except in compliance with - the License. You may obtain a copy of the License at - - http://www.apache.org/licenses/LICENSE-2.0 - - Unless required by applicable law or agreed to in writing, software - distributed under the License is distributed on an "AS IS" BASIS, - WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. - See the License for the specific language governing permissions and - limitations under the License. -//// - NAME ---- sqoop - The SQL-to-Hadoop database import/export tool @@ -76,3 +59,20 @@ The _Sqoop User Guide_ is available in HTML-form in '/usr/share/sqoop/' (if you DEB), or in the 'docs/' directory if you installed from a tarball. +//// + Licensed to Cloudera, Inc. under one or more + contributor license agreements. See the NOTICE file distributed with + this work for additional information regarding copyright ownership. + Cloudera, Inc. licenses this file to You under the Apache License, Version 2.0 + (the "License"); you may not use this file except in compliance with + the License. You may obtain a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, + WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + See the License for the specific language governing permissions and + limitations under the License. +//// +