Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(2060)

Unified Diff: app/views/doc/pub-lish.html

Issue 162403002: Remove docs and point to ones on dartlang.org. (Closed) Base URL: https://github.com/dart-lang/pub-dartlang.git@master
Patch Set: Fit in 80 columns. Created 6 years, 10 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View side-by-side diff with in-line comments
Download patch
« no previous file with comments | « app/views/doc/pub-get.html ('k') | app/views/doc/pub-serve.html » ('j') | no next file with comments »
Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
Index: app/views/doc/pub-lish.html
diff --git a/app/views/doc/pub-lish.html b/app/views/doc/pub-lish.html
deleted file mode 100644
index 173722616b106b285d20c743ab9dbcd56fac60e1..0000000000000000000000000000000000000000
--- a/app/views/doc/pub-lish.html
+++ /dev/null
@@ -1,93 +0,0 @@
-<pre><code>$ pub publish [--dry-run] [--force] [--server &lt;url&gt;]
-</code></pre>
-
-<p>This command publishes your package on
-<a href="http://pub.dartlang.org">pub.dartlang.org</a> for anyone to download and depend
-on. For example, if your package is named transmogrify, it will be listed on
-<code>http://pub.dartlang.org/packages/transmogify</code>, and users can depend on it in
-their pubspecs and get it via <a href="pub-get.html">pub get</a> using something
-like:</p>
-
-<div class="highlight"><pre><code class="dart"><span class="nl">dependencies:</span>
- <span class="nl">transmogrify:</span> <span class="s2">&quot;&gt;= 1.0.0 &lt; 2.0.0&quot;</span>
-</code></pre></div>
-
-<p>When publishing a package, it&rsquo;s important to follow the <a href="pubspec.html">pubspec
-format</a> and <a href="package-layout.html">package layout conventions</a>.
-Some of these are required in order for others to be able to use your package.
-Others are suggestions to help make it easier for users to understand and work
-with your package. In both cases, pub will try to help you by pointing out what
-changes will help make your package play nicer with the Dart ecosystem. There
-are a few additional requirements for uploading a package:</p>
-
-<ul>
- <li>
- <p>You must include a license file (named <code>LICENSE</code>, <code>COPYING</code>, or some
-variation) that contains an <a href="http://opensource.org/">open-source license</a>. We
-recommend the <a href="http://opensource.org/licenses/BSD-2-Clause">BSD license</a>,
-which is used by Dart itself. You must also have the legal right to
-redistribute anything that you upload as part of your package.</p>
- </li>
- <li>
- <p>Your package must be less than ten megabytes large after gzip compression. If
-it&rsquo;s too large, consider splitting it into multiple packages, or cutting down
-on the number of included resources or examples.</p>
- </li>
- <li>
- <p>Your package should only have hosted dependencies. Git dependencies are
-allowed but strongly discouraged; not everyone using Dart has Git installed,
-and Git dependencies don&rsquo;t support version resolution as well as hosted
-dependencies do.</p>
- </li>
-</ul>
-
-<p>Be aware that the email address associated with your Google account will be
-displayed on <a href="http://pub.dartlang.org">pub.dartlang.org</a> along with any packages
-you upload.</p>
-
-<h2 id="what-files-are-published">What files are published?</h2>
-
-<p><strong>All files</strong> in your package will be included in the published package, with
-the following exceptions:</p>
-
-<ul>
- <li>Any <code>packages</code> directories.</li>
- <li>Your package&rsquo;s <a href="glossary.html#lockfile">lockfile</a>.</li>
- <li>If you&rsquo;re using Git, any files ignored by your <code>.gitignore</code> file.</li>
- <li>If you aren&rsquo;t using Git, all &ldquo;hidden&rdquo; files (that is, files whose names begin
-with <code>.</code>).</li>
-</ul>
-
-<p>If there are other files you don&rsquo;t want to include, be sure to delete them (or
-add them to <code>.gitignore</code>) before running <code>pub publish</code>.</p>
-
-<p>To be on the safe side, <code>pub publish</code> will list all files it&rsquo;s going to publish
-for you to look over before it actually uploads your package.</p>
-
-<h2 id="options">Options</h2>
-
-<h3 id="dry-run-or--n"><code>--dry-run</code> or <code>-n</code></h3>
-
-<p>With this, pub goes through the validation process but does not actually upload
-the package. This is useful if you want to see if your package meets all of the
-publishing requirements before you&rsquo;re ready to actually go public.</p>
-
-<h3 id="force-or--f"><code>--force</code> or <code>-f</code></h3>
-
-<p>With this, pub does not ask for confirmation before publishing. Normally, it
-shows you the package contents and asks for you to confirm the upload.</p>
-
-<p>If there are any errors in your package, it is not uploaded and this exits with
-an error. If there are warnings, it <em>will</em> be uploaded. If you want to ensure
-your package has no warnings before uploading, either don&rsquo;t use <code>--force</code>, or
-use <code>--dry-run</code> first.</p>
-
-<h3 id="server"><code>--server</code></h3>
-
-<p>If you pass <code>--server</code> followed by a URL, it will attempt to publish the
-package to that server. It assumes the server supports the same HTTP API that
-<a href="http://pub.dartlang.org">pub.dartlang.org</a> uses.</p>
-
-<p>This can be useful if you&rsquo;re running your own local package server for testing.
-The main pub server is itself open source and available <a href="https://github.com/dart-lang/pub-dartlang">here</a>.</p>
-
« no previous file with comments | « app/views/doc/pub-get.html ('k') | app/views/doc/pub-serve.html » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698