Rename README.win32 to README.windows and add a 64-bit download link.
authorgerald <gerald@f5534014-38df-0310-8fa8-9805f1628bb7>
Fri, 9 Apr 2010 21:42:51 +0000 (21:42 +0000)
committergerald <gerald@f5534014-38df-0310-8fa8-9805f1628bb7>
Fri, 9 Apr 2010 21:42:51 +0000 (21:42 +0000)
Add tools/textify.sh, which makes a Notepad-clickable copy of a text
file. Use it for COPYING, NEWS, README, README.windows, and help/*.txt.

Remove tools/unix2dos.pl and use Cygwin's u2d instead.

git-svn-id: http://anonsvn.wireshark.org/wireshark/trunk@32440 f5534014-38df-0310-8fa8-9805f1628bb7

INSTALL
Makefile.am
Makefile.nmake
README.windows [moved from README.win32 with 60% similarity]
asn1/Makefile.inc.nmake
config.nmake
packaging/nsis/Makefile.nmake
packaging/nsis/wireshark.nsi
tools/textify.sh [new file with mode: 0755]
tools/unix2dos.pl [deleted file]

diff --git a/INSTALL b/INSTALL
index b76c07623f302b99dfbd96f7561de2ac1c6de631..476b68a6f78426c2ea4b8b0f6389539492b875c6 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -14,7 +14,7 @@ Installation
 These are installation instructions for Unix and Unix-like systems
 that can run the "configure" script in this same directory. These
 are not the installation instructions for Windows systems; see
-README.win32 for those instructions.
+README.windows for those instructions.
 
 0. This is software.  Beware.
 
index afd72111a52c49d1591d75beec0f3c76c25fecaa..8afe3f762539a50bf919d11f9672e684e5f33e8d 100644 (file)
@@ -578,7 +578,7 @@ EXTRA_DIST = \
        README.macos            \
        README.tru64            \
        README.vmware           \
-       README.win32            \
+       README.windows          \
        aclocal-fallback/glib-2.0.m4 \
        aclocal-fallback/gtk-2.0.m4 \
        aclocal-flags           \
index 799425eeb0ce92ceb25e0f384a4bd8ba11d58e3d..7eb061fcb91d206c5092595577a8196eb8aa72b7 100644 (file)
@@ -938,11 +938,10 @@ install-generated-files:
        xcopy "doc\AUTHORS-SHORT" $(INSTALL_DIR) /d
        xcopy ".\manuf" $(INSTALL_DIR) /d
        xcopy ".\services" $(INSTALL_DIR) /d
-       xcopy ".\README" $(INSTALL_DIR) /d
-       xcopy ".\README.win32" $(INSTALL_DIR) /d
-       xcopy "doc\AUTHORS-SHORT-FORMAT" $(INSTALL_DIR) /d
-       xcopy ".\COPYING" $(INSTALL_DIR) /d
-       copy ".\NEWS" $(INSTALL_DIR)\NEWS.txt
+       $(TEXTIFY) ".\COPYING" $(INSTALL_DIR)
+       $(TEXTIFY) ".\NEWS" $(INSTALL_DIR)
+       $(TEXTIFY) ".\README" $(INSTALL_DIR)
+       $(TEXTIFY) ".\README.windows" $(INSTALL_DIR)
        xcopy ".\cfilters" $(INSTALL_DIR) /d
        xcopy ".\colorfilters" $(INSTALL_DIR) /d
        xcopy ".\dfilters" $(INSTALL_DIR) /d
@@ -957,8 +956,7 @@ install-generated-files:
        xcopy ".\help\*.*" $(INSTALL_DIR)\help /d
 # you can't reliably use xcopy to rename files "on the fly" (so copy first, then rename)
        xcopy ".\help\faq.txt" $(INSTALL_DIR) /d
-       if exist $(INSTALL_DIR)\FAQ del $(INSTALL_DIR)\FAQ
-       ren $(INSTALL_DIR)\faq.txt FAQ 
+       $(UNIX2DOS) $(INSTALL_DIR)/help/*.txt
        if not exist $(INSTALL_DIR)\dtds mkdir $(INSTALL_DIR)\dtds
        xcopy ".\dtds\*.*" $(INSTALL_DIR)\dtds /d
        if not exist $(INSTALL_DIR)\asn1 mkdir $(INSTALL_DIR)\asn1
similarity index 60%
rename from README.win32
rename to README.windows
index 314ff263535626e8a6ac528d7cc018b145184df9..b44867b865291ce9652da3d507234f5bd365b612 100644 (file)
@@ -1,15 +1,19 @@
 $Id$
 
-Installing Wireshark on Win32
+Installing Wireshark on Windows
 =============================
-To install Wireshark, just download the setup program from:
+To install Wireshark, just download the appropriate installer program from
 
 http://www.wireshark.org/download/win32
 
+or
+
+http://www.wireshark.org/download/win64
+
 and start it. Just keep the default settings and start Wireshark after the 
 installation finished (e.g. using the start menu entry).
 
-For detailed descriptions how to install and use Wireshark and the 
+For detailed descriptions on how to install and use Wireshark and the 
 related command line tools, see the Wireshark User's Guide at: 
 
 http://www.wireshark.org/docs/
@@ -18,7 +22,7 @@ http://www.wireshark.org/docs/
 Compiling the Wireshark distribution from source
 ================================================
 In case you want to develop Wireshark code yourself, you can find a 
-comprehensive guide how to do this in the Developer's Guide, 
-which you can find (and much more info) at: 
+comprehensive guide how to do this in the Developer's Guide,  which
+you can find (and much more info) at: 
 
 http://wiki.wireshark.org/Development
index c15f2c14769a2b22ced0249591a8faacc284b29f..79f6373ec1749743bcfdc10d0c58b5bc3fa78edc 100644 (file)
@@ -21,9 +21,6 @@
 # along with this program; if not, write to the Free Software
 # Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
-
-UNIX2DOS=$(PERL) ../../tools/unix2dos.pl
-
 generate_dissector: $(DISSECTOR_FILES)
 
 generate_export: $(EXPORT_FILES)
@@ -79,15 +76,7 @@ maintainer-clean: distclean
 # the generated stuff has "\n".
 
 fix_eol: generate_dissector
-   <<fix_file.bat
-IF "%1"=="" EXIT
-move %1 %1.tmp
-$(UNIX2DOS) < %1.tmp > %1
-       del /f %1.tmp
-<<
-   <<fix_eol.bat
-FOR %%A IN ($(DISSECTOR_FILES)) DO CALL fix_file.bat %%A
-<<
+       u2d $(DISSECTOR_FILES)
 
 copy_files: generate_dissector
    <<copy_files.bat
index 272e4baedd32e1930b304aceb8e806863121bcf9..a18b60874a01bf3d2d1a0b9fdad523c604a11704 100644 (file)
@@ -1,7 +1,7 @@
 # $Id$
 
-# Some more informations about the settings in this file, can be found
-# in the file README.win32 and the Developer's Guide (available online).
+# Some more information about the settings in this file can be found in
+# the file README.windows and the Developer's Guide (available online).
 
 ##### Target platform #####
 # Only "win32" and "win64" are valid (for now).
@@ -602,6 +602,10 @@ LEX=flex
 # command for yacc/bison (cygwin's bison recommended)
 YACC=bison
 
+# Commands to convert UNIX line endings to DOS/Windows
+UNIX2DOS=u2d
+TEXTIFY=$(SH) $(TOOLS_DIR)/textify.sh
+
 #
 # Optional: To build the NSIS installer.
 #
index 45fcddaec1e3ac2f111e7e8401870c7233844299..2e0e3f6a6fa2f4e8030fbbcbbdacbf0c5d0391c1 100644 (file)
@@ -12,38 +12,37 @@ include ../../config.nmake
 include Custom.nmake
 
 
-UNIX2DOS=$(PERL) ../../tools/unix2dos.pl
-
-
 EXE=../../tshark.exe ../../editcap.exe \
 !IFDEF GTK_DIR
        ../../wireshark.exe \
 !ENDIF
        ../../text2pcap.exe ../../mergecap.exe ../../capinfos.exe WinPcap_4_1_1.exe
 DLL=../../wiretap/wiretap-$(WTAP_VERSION).dll ../../wsutil/libwsutil.dll
-DOC=../../doc/ws.css                   \
-       ../../doc/capinfos.html         \
-       ../../doc/dumpcap.html          \
-       ../../doc/editcap.html          \
-       ../../doc/idl2wrs.html          \
-       ../../doc/mergecap.html         \
-       ../../doc/rawshark.html         \
-       ../../doc/text2pcap.html        \
-       ../../doc/rawshark.html         \
-       ../../doc/tshark.html           \
-       ../../doc/wireshark-filter.html \
-       ../../doc/wireshark.html        \
-       ../../README                    \
-       ../../README.win32
-DOC_dos=NEWS.txt
+DOC=../../doc/ws.css                           \
+       ../../doc/capinfos.html                 \
+       ../../doc/dumpcap.html                  \
+       ../../doc/editcap.html                  \
+       ../../doc/idl2wrs.html                  \
+       ../../doc/mergecap.html                 \
+       ../../doc/rawshark.html                 \
+       ../../doc/text2pcap.html                \
+       ../../doc/rawshark.html                 \
+       ../../doc/tshark.html                   \
+       ../../doc/wireshark-filter.html         \
+       ../../doc/wireshark.html                \
+       ../../$(INSTALL_DIR)/COPYING.txt        \
+       ../../$(INSTALL_DIR)/NEWS.txt           \
+       ../../$(INSTALL_DIR)/README.txt         \
+       ../../$(INSTALL_DIR)/README.windows.txt
+
 GPL=../../COPYING
-HELP=../../help/capture_filters.txt \
-       ../../help/capturing.txt \
-       ../../help/display_filters.txt \
-       ../../help/faq.txt \
-       ../../help/getting_started.txt \
-       ../../help/overview.txt \
-       ../../help/toc
+HELP=../../$(INSTALL_DIR)/help/capture_filters.txt \
+       ../../$(INSTALL_DIR)/help/capturing.txt \
+       ../../$(INSTALL_DIR)/help/display_filters.txt \
+       ../../$(INSTALL_DIR)/help/faq.txt \
+       ../../$(INSTALL_DIR)/help/getting_started.txt \
+       ../../$(INSTALL_DIR)/help/overview.txt \
+       ../../$(INSTALL_DIR)/help/toc
 
 PLUGINS= \
        ../../plugins/asn1/asn1.dll \
@@ -76,7 +75,7 @@ NSI=wireshark.nsi \
 DELIVERABLES=$(EXE) $(DLL) $(DOC) $(DOC_dos) $(GPL) $(HELP) $(PLUGINS)
 
 !IFDEF MAKENSIS
-all: NEWS.txt wireshark-$(WIRESHARK_TARGET_PLATFORM)-$(VERSION).exe
+all: wireshark-$(WIRESHARK_TARGET_PLATFORM)-$(VERSION).exe
 !ELSE
 all: _FORCE_
        @echo ? NSIS not available (MAKENSIS not defined in config.nmake)
@@ -84,9 +83,6 @@ all: _FORCE_
        @exit 1
 !ENDIF
 
-NEWS.txt: ../../NEWS
-       $(UNIX2DOS) < ../../NEWS > NEWS.txt
-
 # fetch the latest available user-guide.chm version
 user-guide.chm::
        if exist ..\..\docbook\user-guide.chm xcopy ..\..\docbook\user-guide.chm . /Y /D
@@ -97,6 +93,7 @@ wireshark-$(WIRESHARK_TARGET_PLATFORM)-$(VERSION).exe : user-guide.chm $(NSI) $(
        /DWIRESHARK_TARGET_PLATFORM=$(WIRESHARK_TARGET_PLATFORM) \
        /DMSVC_VARIANT=$(MSVC_VARIANT) \
        /DWIRESHARK_LIBS=$(WIRESHARK_LIBS) \
+       /DBUILD_DIR=..\..\$(INSTALL_DIR) \
 !IFDEF MSVCR_DLL
        /DMSVCR_DLL="$(MSVCR_DLL)" \
 !ENDIF
index ae4f78157abdd312222965138c53f7c55121a78e..fc26be9f9f1b02e08a4514e21719b67d1a2567b1 100644 (file)
@@ -403,11 +403,11 @@ File "..\..\epan\wslua\dtd_gen.lua"
 !ifdef SMI_DIR
 File "${SMI_DIR}\lib\smi.dll"
 !endif
-File "..\..\README"
-File "..\..\README.win32"
+File "${BUILD_DIR}\COPYING.txt"
+File "${BUILD_DIR}\NEWS.txt"
+File "${BUILD_DIR}\README.txt"
+File "${BUILD_DIR}\README.windows.txt"
 File "..\..\doc\AUTHORS-SHORT"
-File "..\..\COPYING"
-File "NEWS.txt"
 File "..\..\manuf"
 File "..\..\services"
 File "..\..\doc\ws.css"
@@ -652,13 +652,13 @@ File "..\..\wimaxasncp\dictionary.dtd"
 SetOutPath $INSTDIR
 
 SetOutPath $INSTDIR\help
-File "..\..\help\toc"
-File "..\..\help\overview.txt"
-File "..\..\help\getting_started.txt"
-File "..\..\help\capturing.txt"
-File "..\..\help\capture_filters.txt"
-File "..\..\help\display_filters.txt"
-File "..\..\help\faq.txt"
+File "${BUILD_DIR}\help\toc"
+File "${BUILD_DIR}\help\overview.txt"
+File "${BUILD_DIR}\help\getting_started.txt"
+File "${BUILD_DIR}\help\capturing.txt"
+File "${BUILD_DIR}\help\capture_filters.txt"
+File "${BUILD_DIR}\help\display_filters.txt"
+File "${BUILD_DIR}\help\faq.txt"
 
 ; Write the uninstall keys for Windows
 WriteRegStr HKEY_LOCAL_MACHINE "Software\Microsoft\Windows\CurrentVersion\Uninstall\Wireshark" "DisplayVersion" "${VERSION}"
@@ -1079,7 +1079,7 @@ Delete "$INSTDIR\*.exe"
 Delete "$INSTDIR\*.dll"
 Delete "$INSTDIR\*.html"
 Delete "$INSTDIR\ws.css"
-Delete "$INSTDIR\COPYING"
+Delete "$INSTDIR\COPYING*"
 Delete "$INSTDIR\AUTHORS-SHORT"
 ; previous versions installed these files
 Delete "$INSTDIR\*.manifest"
diff --git a/tools/textify.sh b/tools/textify.sh
new file mode 100755 (executable)
index 0000000..b9a7e7e
--- /dev/null
@@ -0,0 +1,50 @@
+#!/bin/bash
+#
+# $Id$
+#
+# Text file conversion script for packaging on Windows
+#
+# This script copies a text file from a source to a destination,
+# converting line endings and adding a ".txt" filename extension
+# if needed. If the destination is a directory the source file
+# name is used. Newer files will not be overwritten.
+#
+# The destination file should be double-clickable and usable
+# when Notepad is the default editor.
+
+SRC="$1"
+DST="$2"
+
+err_exit () {
+    for str in "$@" ; do
+        echo "ERROR: $str"
+    done
+    echo "Usage:"
+    echo "  $0 <source file> <destination file>"
+    echo ""
+    exit 1
+}
+
+if [ -z "$SRC" -o -z "$DST" ] ; then
+    err_exit
+fi
+
+if [ ! -r "$SRC" ] ; then
+    err_exit "Can't read $SRC"
+fi    
+
+if [ -f "$DST" -a "$DST" -nt "SRC" ]; then
+    exit 0
+fi
+
+if [ -d "$DST" ] ; then
+    DSTBASE=`basename "$SRC" txt`
+    DST="$DST/$DSTBASE.txt"
+else
+    DSTDIR=`dirname "$DST"`
+    DSTBASE=`basename "$DST" txt`
+    DST="$DSTDIR/$DSTBASE.txt"
+fi
+
+cp "$SRC" "$DST"
+u2d "$DST"
\ No newline at end of file
diff --git a/tools/unix2dos.pl b/tools/unix2dos.pl
deleted file mode 100755 (executable)
index 9af4ffb..0000000
+++ /dev/null
@@ -1,36 +0,0 @@
-#!/usr/bin/perl -w
-#
-# unix2dos.pl - convert UNIX line endings (\n) in DOS line endings (\r\n)
-# 
-# $Id$
-#
-# Copyright (c) 2004, Olivier Biot
-#
-# Wireshark - Network traffic analyzer
-# By Gerald Combs <gerald@wireshark.org>
-# Copyright 1998 Gerald Combs
-#
-# This program is free software; you can redistribute it and/or
-# modify it under the terms of the GNU General Public License
-# as published by the Free Software Foundation; either version 2
-# of the License, or (at your option) any later version.
-#
-# This program is distributed in the hope that it will be useful,
-# but WITHOUT ANY WARRANTY; without even the implied warranty of
-# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-# GNU General Public License for more details.
-#
-# You should have received a copy of the GNU General Public License
-# along with this program; if not, write to the Free Software
-# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
-
-use strict;
-use warnings;
-
-while (<STDIN>) {
-       if($_ !~ /\r\n/) {
-               $_ =~ s/\n/\r\n/;
-       }
-       print $_;
-}
-1;