Metadata-Version: 1.2
Name: imediff
Version: 2.4
Summary: Interactive Merge Editor for DIFF2/3
Home-page: https://github.com/osamuaoki/imediff
Author: 
Osamu Aoki
Jarno Elonen
Author-email: 
osamu@debian.org
elonen@iki.fi
Maintainer: Osamu Aoki
Maintainer-email: osamu@debian.org
License: GPLv2+
Project-URL: Documentation, https://github.com/osamuaoki/imediff
Description: # IMEDIFF - an interactive fullscreen merge tool for DIFF2/3
        
         * Copyright (C) 2003,2004 Jarno Elonen <elonen@iki.fi>
         * Copyright (C) 2018-2021 Osamu Aoki <osamu@debian.org>
        
        Released under the GNU General Public License, 2.0+.
        See LICENSE for details
        
        The latest upstream source: https://github.com/osamuaoki/imediff
        
        This provides the imediff command and git-ime command.
        
        ## What is imediff
        
        The imediff command helps you to merge 2 slightly different files with an
        optional base file interactively using the in-place alternating display of
        the changed content on a single-pane full screen terminal user interface.
        
        The source of line is clearly identified by the color of the line or the
        identifier character at the first column.
        
        The advantage of this user interface is the minimal movement of the line of
        sight for the user.  Other great tools such as vimdiff, xxdiff, meld and
        kdiff3 require you to look at different points of display to find the exact
        position of changes.  This makes imediff the most stress-free tool.  (I
        realized this when I first used the original imediff2 program by Jarno
        Elonen <elonen@iki.fi>.  Please note that the command name is changed from
        imediff2 to imediff now.)
        
        Other great tools for merge such as "diff3 -m ..." and "git merge ..."
        operate only on the difference by line.  So even for the non-overlapping
        changes, they yield the merge conflict if changes happen on the same line.
        
        The automatic merge logic of the imediff command operates not only on the
        difference by line but on the difference by character.  This is another
        great feature of the imediff command. So for the non-overlapping changes, it
        always yields the clean merge.
        
        ## What is git-ime
        
        This git ime is a simple shell wrapper script on git and imediff to
        split the latest commit from HEAD^ to HEAD on the current git
        repository into multiple commits.
        
        If any staged changes or local uncommitted changes are found in the git
        repository, git ime immediately exits without changes to be on the safe
        side.
        
        If the latest commit involves multiple files, this big commit is split
        by the file into multiple smaller commits involving a single file.
        
        If the latest commit involves only a single file, the commit is split
        into multiple smaller commits involving a set of meaningful partial
        changes selected by imediff interactively.
        
        This git-ime is not only useful at the checked out branch head but also
        at "edit" prompt during the interactive execution of git rebase -i
        treeish.
        
        ## Quick start
        
        At the console command line prompt, type:
         * "imediff" to read the tutorial,
         * "imediff -h" to get all the command line options,
         * "imediff -o output older newer" to merge 2 files, and
         * "imediff -o output yours base theirs" to merge 3 files.
        
        For usage instructions, type "h" and "H" in the interactive display.
        
        If you wish to translate "h" menu, send me a translation PO file :-)
        
        You can get Japanese help screen by setting and exporting "LANGUAGE=ja:en".
        
        (This uses GNU gettext as its backend.  LANGUAGE setting has priority
        over setting of LC_ALL etc.)
        
        ## History and features
        
        This was originally written by Jarno Elonen in Python2. The latest original
        upstream version was 1.1.2 released on 2007-8-18.
        
        The original author's website was https://elonen.iki.fi/code/imediff/ .
        Now it redirects to this site https://github.com/osamuaoki/imediff .
        
        Osamu Aoki made a minor patched release for Debian buster in Oct 2018.
        
         * No more surprise hitting "q".  You will be asked. (Fix Debian bug #799865)
         * Fix manpage generation issue (Fix Debian bug #860351)
         * New git-ime wrapper script (great for git rebase/un-squash commit)
         * You can customize key bindings.
        
        Osamu also wanted to add some features:
        
         * Use of Python3 with setup.py and setuptools to organize the source into
           multiple source files.
         * Use standard libraries for the flexible customization
           (argparse, configparser, logging)
         * Addition of diff3 merge capability
         * Addition of wdiff capability
         * Addition of cursor location display capability
         * Make it edit highlighted section only
         * Make its TUI more friendly under monochrome terminal
         * Use curses.wrapper()
         * CLI and logging interface for easy self-testing/debugging
         * Add decent test cases
         * Include simple tutorial within "imediff".
         * Add "git-mergetool" integration.
         * Add "git-ime" to help making partial patch series commits to git.
         * Good CJK wide character support with East_Asian_Width on console.
        
        This was accomplished by practically a whole rewrite of the source code in
        November-December 2018.  Osamu decided to release this as imediff after
        consulting with Jarno Elonen. Now program name is without "2", since it
        supports diff for not only 2 files but also 3 files.  The version number is
        bumped to 2.0.
        
        ## Note to developer and translator
        
        ### making Debian package
        
        You can make your own Debian package as:
        
            $ git clone https://github.com/osamuaoki/imediff.git
            $ cd imediff
            $ git checkout main
             ... hack source
            $ git commit -a
            $ git checkout upstream
            $ git merge main
            $ rm -rf debian
            $ git add -A .
            $ git commit
            $ git tag 2.0
            $ git checkout main
            $ git deborig main # to make ../*.orig.tar.xz
            $ sbuild
            $ cd ..
            $ sudo dpkg -i imediff_2.0-1_all.deb
        
        Here, we assume the upstream version to be 2.0, and the Debian revision to be 1
        as defined in debian/changelog.  I was using gbp-like
        main/upstream/pristine-tar work flow but I will probably my work flow simple by
        just updating main branch and will create upstream tagged release by removing
        `debian/*` for every *.*-1 release as above.
        
        If you have bug fixes or feature enhancement propose changes to me via "pull
        request"
        
        ### updating manpages
        
        Please make sure to fit each code below 80-88 chars. (Run "black" on python
        code)  In case if reformat errors, check its syntax by:
        
           $ python3 -m py_compile program.py
        
        Manpages need to be updated from XML files with "make" first in doc/ directory
        when you edit it.
        
        ### updating PO
        
        Tutorial contents should be within 76 chars/line to fit in console.
        
        Update PO with:
        
            $ ./setup.py build_i18n -m
        
        If anyone wants more contents to be translated such as manpage and tutorial,
        adding po4a may be a good idea.  For now, let's keep it minimal.
        
        ### testing code
        
        If you make changes, please test then.
        
        To test the in-source-tree module, invoke the test script from setup.py in the
        root of the source tree as:
        
            $ python3 setup.py test
        
        To test the installed module, invoke the test script directly as:
        
            $ cd test
            $ python3 test_diff23lib.py -v
        
        ## Note on Debian package links
        
        * imediff2 (based on older python2 source for and before stretch)
          * https://tracker.debian.org/pkg/imediff2
          * https://packages.debian.org/source/sid/imediff2 (source package in Debian)
          * https://packages.debian.org/sid/imediff2 (binary package in Debian)
          * https://bugs.debian.org/cgi-bin/pkgreport.cgi?repeatmerged=0;src=imediff2 (BTS)
        
        * imediff: (based on newer python3 source for buster)
          * https://tracker.debian.org/pkg/imediff
          * https://packages.debian.org/source/sid/imediff (source package in Debian)
          * https://packages.debian.org/sid/imediff (binary package in Debian)
          * https://bugs.debian.org/cgi-bin/pkgreport.cgi?repeatmerged=0;src=imediff (BTS)
        
        This is written and updated by Osamu Aoki on June 2021.
        
        
Keywords: imediff
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Topic :: Text Processing :: General
Classifier: Environment :: Console :: Curses
Classifier: License :: OSI Approved :: GNU General Public License v2 or later (GPLv2+)
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.4
