You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@freemarker.apache.org by dd...@apache.org on 2021/02/07 18:49:27 UTC

[freemarker-site] branch asf-site updated: Updated committer-howto

This is an automated email from the ASF dual-hosted git repository.

ddekany pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/freemarker-site.git


The following commit(s) were added to refs/heads/asf-site by this push:
     new 4d627a3  Updated committer-howto
4d627a3 is described below

commit 4d627a36a96c0d91dd9df17ad387f53ccaf584d3
Author: ddekany <dd...@apache.org>
AuthorDate: Sun Feb 7 19:49:17 2021 +0100

    Updated committer-howto
---
 committer-howto.html | 52 ++++++++++++----------------------------------------
 1 file changed, 12 insertions(+), 40 deletions(-)

diff --git a/committer-howto.html b/committer-howto.html
index 5410ec3..7cb1f8c 100644
--- a/committer-howto.html
+++ b/committer-howto.html
@@ -294,10 +294,6 @@ ga('send', 'pageview');
           </li>
 
           <li>
-            <p><code class="inline-code">ant update-deps</code></p>
-          </li>
-
-          <li>
             <p><code class="inline-code">ant dist</code></p>
           </li>
 
@@ -615,20 +611,17 @@ ga('send', 'pageview');
           <li>
             <p>The contents of <code class="inline-code">docs/</code> is generated from
             the <code class="inline-code">freemarker</code> project, by issuing <code class="inline-code">ant
-            manualFreemarkerOrg</code>. So to change the content, you
-            should edit
+            manualOnline</code>. So to change the content, you should edit
             <code class="inline-code"><em class="code-color">&lt;freemarker-project&gt;</em>/src/manual/en_US/book.xml</code>.</p>
           </li>
 
           <li>
             <p>Most other content is generated from the
-            <code class="inline-code">site</code> project, by issuing
-            <code class="inline-code">ant</code>. So to change the content, you should edit
+            <code class="inline-code">site</code> project, by issuing <code class="inline-code">mvn -U
+            package</code>. So to change the content, you should edit
             <code class="inline-code"><em class="code-color">&lt;site-project&gt;</em>/src/main/docgen/book.xml</code>
             (in the <code class="inline-code">master</code> branch, not in the
-            <code class="inline-code">asf-site</code> branch). To ensure that you are using
-            the latest Docgen, you may want to issue <code class="inline-code">ant
-            update-deps</code> before generating.</p>
+            <code class="inline-code">asf-site</code> branch).</p>
           </li>
         </ul>
 
@@ -652,33 +645,12 @@ ga('send', 'pageview');
         binary release building (as that contains the Manual in HTML format)
         and of <code class="inline-code">freemarker-site</code>.</p>
 
-        <p>Docgen is not published to the Maven Central Repository, as it&#39;s
-        only used as an internal build dependency. Currently, it&#39;s published
-        manually to the internal Ivy repository of the project, which is under
-        https://freemarker.apache.org/repos/ivy/. If you modify Docgen, don&#39;t
-        forget to publish there, or else the next site update or FreeMarker
-        release will use an outdated version. For that:</p>
-
-        <div class="orderedlist"><ol type="1">
-          <li>
-            <p><code class="inline-code">ant server-publish-last-build</code></p>
-          </li>
-
-          <li>
-            <p>Upload the content of the resulting
-            <code class="inline-code">build\dummy-server-ivy-repo</code> directory to
-            <code class="inline-code">https://freemarker.apache.org/repos/ivy/</code>. See
-            how to update the contents of freemarker.apache.org <a href="#updating-homepage">here...</a></p>
-          </li>
-
-          <li>
-            <p>If you want to use the published version in the
-            <code class="inline-code">freemarker</code> or
-            <code class="inline-code">freemarker-site</code> projects, don&#39;t forget to issue
-            <code class="inline-code">ant update-deps</code> there, or else they will keep
-            using their local copy of the last obtained version.</p>
-          </li>
-        </ol></div>
+        <p>Docgen is not published to the Maven Central Repository (yet?),
+        only into the Apache Maven Snapshot Repository. That works for us
+        because it&#39;s an internal build dependency, and the dependent projects
+        are set up to find it in the Apache Maven Snapshot Repository. If you
+        modify Docgen, just issue <code class="inline-code">mvn deploy</code> to make the
+        new version available for the later dependent builds.</p>
       
         
 
@@ -734,9 +706,9 @@ ga('send', 'pageview');
     </div>
 <div class="site-footer"><div class="site-width"><div class="footer-top"><div class="col-left sitemap"><div class="column"><h3 class="column-header">Overview</h3><ul><li><a href="index.html">What is FreeMarker?</a></li><li><a href="freemarkerdownload.html">Download</a></li><li><a href="docs/app_versions.html">Version history</a></li><li><a href="history.html">About us</a></li><li><a itemprop="license" href="docs/app_license.html">License</a></li></ul></div><div class="column"><h3 class=" [...]
 Last generated:
-<time itemprop="dateModified" datetime="2020-08-03T23:21:26Z" title="Monday, August 3, 2020 at 11:21:26 PM Greenwich Mean Time">2020-08-03 23:21:26 GMT</time> </p>
+<time itemprop="dateModified" datetime="2021-02-07T18:46:44Z" title="Sunday, February 7, 2021 6:46:44 PM GMT">2021-02-07 18:46:44 GMT</time> </p>
 <p class="copyright">
-© <span itemprop="copyrightYear">1999</span>–2020
+© <span itemprop="copyrightYear">1999</span>–2021
 <a itemtype="http://schema.org/Organization" itemprop="copyrightHolder" href="http://apache.org/">The Apache Software Foundation</a>. Apache FreeMarker, FreeMarker, Apache Incubator, Apache, the Apache FreeMarker logo are trademarks of The Apache Software Foundation. All other marks mentioned may be trademarks or registered trademarks of their respective owners. </p>
 </div></div></div></body>
 </html>