- added a quick hack to enable variable expansions in the help file. This is...

- added a quick hack to enable variable expansions in the help file. This is often more convenient than forcing localized messages to go into a properties file.
- added a download link for slave.jar


git-svn-id: https://hudson.dev.java.net/svn/hudson/trunk/hudson/main@17237 71c3de6d-444a-0410-be80-ed276b4c234a

core/src/main/java/hudson/model/Descriptor.java

@@ -25,6 +25,7 @@ package hudson.model;
 
 import hudson.XmlFile;
 import hudson.BulkChange;
+import hudson.Util;
 import static hudson.Util.singleQuote;
 import hudson.scm.CVSSCM;
 import net.sf.json.JSONArray;
@@ -52,6 +53,7 @@ import java.util.Map;
 import java.util.HashMap;
 import java.util.Locale;
 import java.util.Arrays;
+import java.util.Collections;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.logging.Level;
 import java.util.logging.Logger;
@@ -524,8 +526,10 @@ public abstract class Descriptor<T extends Describable<T>> implements Saveable {
             return;
         }
 
+        // TODO: generalize macro expansion and perhaps even support JEXL
         rsp.setContentType("text/html;charset=UTF-8");
-        IOUtils.copy(in,rsp.getOutputStream());
+        String literal = IOUtils.toString(in,"UTF-8");
+        rsp.getWriter().println(Util.replaceMacro(literal, Collections.singletonMap("rootURL",req.getContextPath())));
         in.close();
     }
 

core/src/main/resources/hudson/slaves/CommandLauncher/config.jelly

@@ -23,7 +23,7 @@ THE SOFTWARE.
 -->
 
 <j:jelly xmlns:j="jelly:core" xmlns:st="jelly:stapler" xmlns:d="jelly:define" xmlns:l="/lib/layout" xmlns:t="/lib/hudson" xmlns:f="/lib/form">
-  <f:entry title="${%Launch command}" help="/help/system-config/master-slave/command.html">
-    <f:textbox field="command" />
+  <f:entry title="${%Launch command}" field="command">
+    <f:textbox />
   </f:entry>
 </j:jelly>
\ No newline at end of file

war/resources/help/system-config/master-slave/command.html → core/src/main/resources/hudson/slaves/CommandLauncher/help-command.html

@@ -5,8 +5,7 @@
     slave machine.
 
   <p>
-  A copy of <tt>slave.jar</tt> can be found in <tt>WEB-INF/slave.jar</tt> inside
-  <tt>hudson.war</tt>.
+  A copy of <tt>slave.jar</tt> can be downloaded from <a href="${rootURL}/jnlpJars/slave.jar"><tt>here</tt></a>.
 
   <p>
   In a simple case, this could be

war/resources/help/system-config/master-slave/command_de.html → core/src/main/resources/hudson/slaves/CommandLauncher/help-command_de.html

@@ -8,8 +8,7 @@
   das Programm <tt>slave.jar</tt> auf dem jeweiligen Slave-Knoten startet.
 
   <p>
-  <tt>slave.jar</tt> befindet sich als <tt>WEB-INF/slave.jar</tt> im Archiv
-  <tt>hudson.war</tt>.
+  <tt>slave.jar</tt> befindet sich als <a href="${rootURL}/jnlpJars/slave.jar"><tt>WEB-INF/slave.jar</tt></a>.
 
   <p>
   Ein einfachen Fällen, könnte der Befehl zum Beispiel so aussehen:

war/resources/help/system-config/master-slave/command_fr.html → core/src/main/resources/hudson/slaves/CommandLauncher/help-command_fr.html

-<div>
+<div>
   La commande à utiliser pour lancer un agent esclave, qui contrôle la
   machine-esclave et communique avec la machine-maître.
 
@@ -19,7 +19,8 @@
   programme <tt>slave.jar</tt> sur la bonne machine esclave.
 
   <p>
-  Une copie du <tt>slave.jar</tt> est disponible dans le répertoire <tt>WEB-INF</tt> du fichier <tt>hudson.war</tt>.
+  Une copie du <tt>slave.jar</tt> est disponible dans le répertoire
+    <a href="${rootURL}/jnlpJars/slave.jar"><tt>WEB-INF/slave.jar</tt></a>.
 
   <p>
   Pour un cas simple, cette commande pourrait être du type

war/resources/help/system-config/master-slave/command_ja.html → core/src/main/resources/hudson/slaves/CommandLauncher/help-command_ja.html

@@ -7,7 +7,7 @@
   Hudsonは、その実行コマンドが正しいスレーブマシーン上で<tt>slave.jar</tt>を起動することを想定しています。
 
   <p>
-  <tt>slave.jar</tt>のコピーが、<tt>hudson.war</tt>の中の<tt>WEB-INF/slave.jar</tt>にあります。
+  <tt>slave.jar</tt>のコピーが、<tt>hudson.war</tt>の中の<a href="${rootURL}/jnlpJars/slave.jar"><tt>WEB-INF/slave.jar</tt></a>にあります。
 
   <p>
   シンプルなケースでは、このコマンドは"ssh <i>hostname</i> java -jar ~/bin/slave.jar"のようなものになります。

core/src/main/resources/hudson/slaves/CommandLauncher/help-command_pt_BR.html

+<div>
+  Comando para ser usado para lan�ar o program agente na m�quina slave, o qual controla o
+  computador slave e se comunica com o master.
+
+  <h3>Agentes slave JNLP</h3>
+  <p>
+  Deixe este campo vazio se voc� quiser lan�ar os agentes slave via JNLP.
+  Com esta configura��o, a p�gina de informa��es do slave (hudson/computer/***/) 
+  ter� um �cone de lan�amento JNLP, e voc� poder� clicar no link da m�quina slave
+  correta para lan�ar o agente slave via JNLP.
+  <p>
+  Este modo � conveniente para slaves Windows que frequentemente n�o tem um mecanismo
+  de execu��o remota.
+
+  <h3>Agentes slave ssh/rsh</h3>
+  <p>
+  Quando um comando real � especificado neste campo,
+  este comando � executado na m�quina
+  master, e o Hudson assume que o programa executado lan�a o programa <tt>slave.jar</tt>
+  na m�quina slave correta.
+
+
+  <p>
+  Uma c�pia de <tt>slave.jar</tt> pode ser encontrada em <a href="${rootURL}/jnlpJars/slave.jar"><tt>WEB-INF/slave.jar</tt></a> dentro de
+  <tt>hudson.war</tt>.
+
+  <p>
+  Em um simples caso, isto poderia ser
+  algo como "ssh <i>hostname</i> java -jar ~/bin/slave.jar".
+
+  Entretanto, � uma boa id�ia escrever um pequeno shell script, como o seguinte, em um slave
+  tal que voc� possa controlar a localiza��o do Java e/ou slave.jar, bem como configurar
+  qualquer vari�vel de ambiente espec�fica para este n� slave, tal como PATH.
+  
+<pre>
+#!/bin/sh
+exec java -jar ~/bin/slave.jar
+</pre>
+
+  <p>
+  Voc� pode usar qualquer comando para executar um processo na m�quina slave, tal como RSH,
+  desde que as entrada/sa�da padr�o (stdin/stdout) deste processo estejam eventualmente
+  conectadas a "java -jar ~/bin/slave.jar".
+
+  <p>
+  Em uma grande implanta��o, tamb�m � valioso considerar carregar <tt>slave.jar</tt> de
+  uma localiza��o comum montada via NFS, assim voc� n�o tem que atualizar este arquivo toda vez
+  que voc� atualizar o Hudson.
+
+  <p>
+  Definir isto como "ssh -v <i>hostname</i>" pode ser �til para depurar quest�es de
+  conectividade.
+</div>

war/resources/help/system-config/master-slave/command_ru.html → core/src/main/resources/hudson/slaves/CommandLauncher/help-command_ru.html

@@ -7,7 +7,7 @@
   что эта команда запустит <tt>slave.jar</tt> на соответствующем подчиненном узле.
 
   <p>
-  Копия файла <tt>slave.jar</tt> вы можете найти в <tt>WEB-INF/slave.jar</tt> внутри 
+  Копия файла <tt>slave.jar</tt> вы можете найти в <a href="${rootURL}/jnlpJars/slave.jar"><tt>WEB-INF/slave.jar</tt></a> внутри 
   <tt>hudson.war</tt>.
 
   <p>

war/resources/help/system-config/master-slave/command_tr.html → core/src/main/resources/hudson/slaves/CommandLauncher/help-command_tr.html

@@ -8,7 +8,7 @@
 
 
   <p>
-  <tt>slave.jar</tt>'&#305;n bir kopyas&#305;, <tt>hudson.war</tt>'&#305;n i&#231;erisinde <tt>WEB-INF</tt>
+  <a href="${rootURL}/jnlpJars/slave.jar"><tt>slave.jar</tt></a>'&#305;n bir kopyas&#305;, <tt>hudson.war</tt>'&#305;n i&#231;erisinde <tt>WEB-INF</tt>
   klas&#246;r&#252; alt&#305;nda bulunabilir.
 
   <p>

war/resources/help/system-config/master-slave/command_pt_BR.html

-<div>
-  Comando para ser usado para lançar o program agente na máquina slave, o qual controla o
-  computador slave e se comunica com o master.
-
-  <h3>Agentes slave JNLP</h3>
-  <p>
-  Deixe este campo vazio se você quiser lançar os agentes slave via JNLP.
-  Com esta configuração, a página de informações do slave (hudson/computer/***/) 
-  terá um ícone de lançamento JNLP, e você poderá clicar no link da máquina slave
-  correta para lançar o agente slave via JNLP.
-  <p>
-  Este modo é conveniente para slaves Windows que frequentemente não tem um mecanismo
-  de execução remota.
-
-  <h3>Agentes slave ssh/rsh</h3>
-  <p>
-  Quando um comando real é especificado neste campo,
-  este comando é executado na máquina
-  master, e o Hudson assume que o programa executado lança o programa <tt>slave.jar</tt>
-  na máquina slave correta.
-
-
-  <p>
-  Uma cópia de <tt>slave.jar</tt> pode ser encontrada em <tt>WEB-INF/slave.jar</tt> dentro de
-  <tt>hudson.war</tt>.
-
-  <p>
-  Em um simples caso, isto poderia ser
-  algo como "ssh <i>hostname</i> java -jar ~/bin/slave.jar".
-
-  Entretanto, é uma boa idéia escrever um pequeno shell script, como o seguinte, em um slave
-  tal que você possa controlar a localização do Java e/ou slave.jar, bem como configurar
-  qualquer variável de ambiente específica para este nó slave, tal como PATH.
-  
-<pre>
-#!/bin/sh
-exec java -jar ~/bin/slave.jar
-</pre>
-
-  <p>
-  Você pode usar qualquer comando para executar um processo na máquina slave, tal como RSH,
-  desde que as entrada/saída padrão (stdin/stdout) deste processo estejam eventualmente
-  conectadas a "java -jar ~/bin/slave.jar".
-
-  <p>
-  Em uma grande implantação, também é valioso considerar carregar <tt>slave.jar</tt> de
-  uma localização comum montada via NFS, assim você não tem que atualizar este arquivo toda vez
-  que você atualizar o Hudson.
-
-  <p>
-  Definir isto como "ssh -v <i>hostname</i>" pode ser útil para depurar questões de
-  conectividade.
-</div>