*******************************************************************************
| |
| mlak README |
| (mz Log Analysis K) |
| |
*******************************************************************************
Last Update : 2012.4.7
* This file is encoded with UTF-8
===============================================================================
| Release Notes |
===============================================================================
MLAK_0.7 - 2012.4.7 (Sat)
(R) MLAK_0.7
(N) [#54] [mlak] New pref/ftr - Removal string upon loading
파일 loading 또는 clipboard 복사시 "특정문자열"을 처음부터 loading 하지 않도록
하는 새로운 기능 (최대 6개까지 설정 가능)
MLAK_0.6 - 2012.3.3 (Sat)
(R) MLAK_0.6
(+) [#53] [mlak] Progress dialog box display when display only
-. File loading과 text display때 progress dialog box 보여주는 기능 추가
-o- [#52] [mlak] Abort exception when the end line copy in ^H mode
-. ^H mode인 경우 맨 마지막 라인을 복사하려 할때 abort exception 발생하는
문제 수정
-o- [#51] [mlak] Wrong line copied to clipboard in ^H mode
-. ^H mode인 경우 Ctrl+C 키로 복사할 때 enable되어 있는 filter의 종류에
상관없이 항상 잘못된 라인들이 복사되는 문제 수정
-o- [#50] [mlak] Wrong behavior of 'append line num' option in ^H mode
-. ^H mode인 경우 'append line num' option의 값이 enable일때 clipboard로
복사시 disable 된 경우로 동작하는 (서로 반대로 동작하는) 문제 수정
(N) [#37] [mlak] New ftr - Command line arguments for log file
-. Command line argument 기능 추가 (log 파일만 loading)
-. 실행 방법
mlak.exe [log_file_name]
-o- [#45] [mlak] Wrong lines copied to clipboard when only excluding filters are enabled
-. ^H mode인 경우 Excluding filter 만 enable되어 있는 상태에서 Ctrl+C 눌러 복사할때
잘못된 라인들이 복사되는 문제 수정
(+) label max length를 12에서 24로 변경
(+) global shortcut Ctrl+D (show only filtered lines) 추가
(+) edit filter dlg에서 current priority가 숫자로 표시되는 것 영문자로 표시되도록 수정
MLAK_0.5 - 2012.2.26 (Sun)
(R) MLAK_0.5
(!) readme에 User Manual 부분 추가
(N) [#49] [mlak] New ftr - Space key selection in flt window
-. Filter window에서 space key로 filter의 toggle 기능 추가
-o- [#48] [mlak] Assertion error when filter deletion
-. 필터 지울때 ABORT 에러 발생하는 문제 수정
-o- [#46] [mlak] Program exception abort when the last one filter deletion
-. 필터 한개만 있을때 마지막 필터를 지울때 abort exception 발생하는 문제 수정
(+) [#47] [mlak] Busy dialog box display when file load and display
-. File load와 display때 busy dialog box 보여주는 기능 추가
(+) [#43] [mlak] Error popup display in case of no text string when filter creation and edit
-. Filter 생성, 편집시 text string 입력하지 않을 경우 경고창 출력
(N) [#42] [mlak] New ftr - Window size and position save and restore when next launch
-. Win size, poisition을 저장해 다음 실행시 복원하는 기능 추가
(N) [#41] [mlak] New ftr - Drag & drop for log file open
-. Drag & drop 기능 추가
(N) [#38] [mlak] New ftr/pref - Default filter file setting
-. Default filter 파일을 설정하는 기능 추가
-o- [#39] [mlak] Wrong lines copied when a lot of lines are selected in log window
-. 한페이지가 넘어가도록 선택하면 copy가 제대로 안되는 문제 수정
(N) [#34] [mlak] New ftr - Excluding opiton in filter
-. Filter에 excluding option 기능 추가
(N) [#36] [mlak] New ftr/pref - Do not display blank line
-. 빈줄은 보여주지 않는 기능, pref에도 추가
-o- [#35] [mlak] Not update after edit filter except priority change
-. Filter edit 후 filter의 update가 안되는 문제 수정
(N) [#33] [mlak] New ftr/pref - tab character display with space characters
-. tab 문자를 space로 대체하여 표시하는 기능 추가
(N) [#32] [mlak] New ftr - 'space' key shortcut (fwd direction only)
-. 'space' key를 누를 경우 필터에 걸린 문자열로 이동하는 기능 추가
어떤 필터에 걸렸는지 상관없이 무조건 필터에 걸린 문자열로 이동
MLAK_0.4 - 2012.2.19 (Sun)
(R) MLAK_0.4
-o- [#31] [mlak] Cannot load file which contains string line which has one char
-. 한 라인이 char 하나만으로 되어있는 파일을 읽을때 무한루프 빠지는 문제 수정
(N) [#30] [mlak] New feature - Paste from clipboard
-. Clipboard에 들어있는 문자열을 log window에 붙여넣는 기능 추가
-o- [#29] [mlak] Cannot load the pref for font face, size, fgcolor, bgcolor
-. font face와 size, bgcolor, fgcolor 값등을 읽어오지 못하는 문제 수정
(N) [#28] [mlak] New pref - Appending line number text when copy to clipboard
-. Clipboard로 log line을 복사할 때 맨 앞에 line number를 붙이는 기능을
pref의 option으로 추가
(N) [#27] [mlak] New feature - Multi-selection copy to clipboard
-. Multi-line을 선택하여 clipboard로 복사하는 기능 추가
MLAK_0.3 - 2012.2.19 (Sun)
(R) MLAK_0.3 release (beta)
-o- [#26] [mlak] ^H mode change error in case of the log file which has no filtered line
-. 필터에 걸린 문자열이 하나도 없는 log 파일의 경우 ^H 모드 전환이
잘 안되던 문제 수정
(N) [#25] [mlak] Shortcut key for the specified filtered line in log window
-. 필터된 문자열로 바로 이동하는 단축키 기능 추가
(+) [#24] [mlak] Change priority '1...' to priority 'A...' in GUI
-. 필터 priority 표시되는 값을 숫자에서 영문자(대문자)로 변경
-o- [#23] [mlak] Cannot display with the user-input bgcolor in filter window
-. 필터에서 bg color 적용 안되던 문제 수정
-. wxCheckedListCtrl에서 bgcolor를 변경하고 있었음
(N) [#22] [mlak] Opened log line filename display in window title
-. Window title에 open한 log file name 표시하는 기능 추가 완료
(N) [#21] [mlak] Current log line copy to clipboard
-. Clipboard로 복사하는 기능 추가 완료
MLAK_0.2 - 2012.2.18 (Sat)
(R) MLAK_0.2 release (beta)
MLAK_0.1 - 2012.2.14 (Tue)
(R) MLAK_0.1 release (beta)
===============================================================================
| Known Issues |
===============================================================================
MLAK_0.5 - 2012.2.26 (Sun)
-x- [#44] [mlak] Excluding flt and normal flt enabled / ^H mode issue #1
-. Excluding flt가 enable되어 있고 Normal flt가 enable되어 있는 상태에서
normal flt에 걸린 line이 하나도 없을때 ^H mode에서는 빈화면을 보여야 하는데
그렇지 못하고 excluding flt가 안걸린 normal line을 보여주는 문제
-x- [#40] [mlak] Log file open error (infinite loop)
-. 특정 폴더 (긴이름?) 에서 파일을 열때 파일을 열지 못하고 무한루프 빠지는 문제
MLAK_0.2 - 2012.2.18 (Sat)
-x- [#14] [mlak] 한글이 들어가 있는 txt 파일 loading때 죽는 현상 (abort)
===============================================================================
| Key Features |
===============================================================================
0. 모든 기능은 TextAnalysisTool.NET (by David Anson)과 거의 동일하다
** mlak과 TextAnalysisTool.NET의 기능 비교
-----------------------------------------------------------------------------
Features mlak mlak mlak mlak TAT.NET
0.4 0.5 0.6 0.7 2006-12-04
-----------------------------------------------------------------------------
1) 텍스트 파일 Viewer 기능
File loading O <- O
Reloading X <- O
Save current line X <- O
2) Filter 기능
Filtered only view 기능 O <- O
Filter priority 변경
임의의 priority로 변경 O <- X
한 단계만 up/down 변경 O <- O
Filter 추가/삭제 O <- O
Filter FG color 적용 O <- O
Filter BG color 적용 O <- X
Filter excluding option 기능 X O O
모든 filter disable 기능 X <- O
모든 filter 삭제 기능 X <- O
Bookmark filtering 기능 X <- O
Filter window에서 context menu O <- O
3) Edit 관련 기능
Copy to Clipboard (Multi-line) O <- O
Paste from Clipboard (Multi-line) O <- O
Select All X <- O
Find/Search O <- O
Regular Expression O <- O
RegEx validation check O <- O
Go to the specified line X <- O
4) 단축키 관련 기능
Bookmark 추가 X <- O
Bookmark 위치로 바로 이동 X <- O
특정 filter에 걸린 line으로
바로 이동 O <- O
Space 키로 임의의 fliter에
걸린 line으로 바로 이동 X O O
5) User customization 기능
Default font face 변경 O <- X
Default font size 변경 O <- O
검색했던 문자열 저장 O <- X
Clipboard 복사시 line number
추가할 수 있는 선택 기능 O <- X
최근 사용 문서 리스트 저장 X <- X
Default Filter 지정 X O X
빈 줄은 보여주지 않는 기능 X O X
Tab을 지정된 공백 개수 만큼
보여주는 기능 X O O
Log 파일 or clipboard 텍스트에서
특정 문자열을 지우고 loading X X X O X
6) 기타 기능
Command line input parameter X <- O O
도움말(text file) O <- O
Plugin 기능 X <- O
TAT filter import 기능 O <- N/A
Log file drag & drop 기능 X O O
프로그램의 화면상 실행 위치와
창 크기 복원 기능 X O O
7) Performance 관련
450KB 정도의 log file
loading 시간 약 2.2초 <- 약 0.7초
대용량(80MB~) 파일 loading (불가능?) <- 가능
화면 깜빡이는 현상 없음 <- 있음
Log window scroll 속도 약간 빠름 <- 약간 느림
-----------------------------------------------------------------------------
===============================================================================
| Information |
===============================================================================
1. 사용 가능한 운영체제
-. Windows XP
(Windown 7, 64bit에서는 검증 안됨)
2. mlak build tools
-. Code::Blocks 10.05 (Cross-Platform IDE)
-. TDM-GCC 4.6.1 (C++ Compiler)
-. wxWidget 2.9.3 (Cross-Platform GUI Toolkit Library)
-. wxFormBuilder 3.1 (Open Source GUI Builder for wxWidgets)
3. mlak에 사용된 open source library
-. Boost C++ 1.48.0 RegEx library for regular expression engine
-. pugixml library for XML file handling
===============================================================================
| User Manual |
===============================================================================
1. 개요
mlak은 텍스트 파일로 되어 있는 로그파일을 분석하는데 도움을 주고자 하는 tool이다.
당연한 얘기지만 굳이 로그파일 분석하는데만 사용할 필요는 없다.
어떤 텍스트 파일도 내가 찾고자 하는 정보를 쉽게 얻을 수 있으므로 무한한 활용이
가능하다.
기본적으로 TextAnalysisTool.NET (by David Anson) (이하 TAT.NET)이 보유한 기능의
약 90% 정도를 갖고 있으며 사용 방법은 완전히 동일하다.
-. TAT.NET 저자의 블로그
http://blogs.msdn.com/b/delay/archive/2011/09/22/textanalysistool-net-to-windows-8-quot-y-u-no-run-me-under-net-4-quot-how-to-avoid-the-quot-please-install-net-3-5-quot-dialog-when-running-older-net-applications-on-the-windows-8-developer-preview.aspx
-. TAT.NET 다운로드링크
http://cesso.org/Samples/TextAnalysisTool.NET/TextAnalysisTool.NET.zip
그러나 TAT.NET에는 없는, 아래에 명시한 편리하고 사소한 기능들 몇가지를 더 추가하여
구현하였으므로 그럭저럭 쓸만하다. (자화자찬;;)
-. Default font face 변경 가능
-. Filter background color 설정
-. Filter 생성시 항상 최상위 priority로 생성하는 기능
-. Filter priority 변경시 임의의 priority로 변경 가능
-. 프로그램 loading시 default filter open 기능
-. Log file에서 blank line 보여주지 않도록 선택하는 기능
-. Clipboard 복사시 라인수 텍스트를 붙이지 않도록 선택하는 기능
한편 TAT.NET에 있는 아래의 기능은 아직까지는(mlak 0.5 기준) 지원하지 않는다.
차차 시간이 되면 몇가지 필요하다 싶은 기능들은 순차적으로 구현할 계획이나
그게 언제될지는 본인도 기약할 수 없다;;
-. Bookmark 기능
-. Filter에서 bookmark를 설정할 수 있는 기능
-. Reloading, save current line 기능
-. 모든 filter의 disable 기능, 모든 filter 삭제 기능
-. Select all 기능
-. 특정 라인으로 바로 이동하는 기능
-. Plugin 기능
단, TAT.NET의 최고 장점 중의 하나인 대용량 파일의 open 기능과 빠른 loading 속도는
아직 본인의 실력이 미천한 관계로 잘 동작하지 않거나 문제가 있을 수 있다.
그러므로 그때는 TAT.NET을 사용하는것이 정신건강상 이롭다.
2. 개념
1) 필터
: 내가 찾고자 하는 관심있는 문자열을 찾기 위한 검색 문자열
(일반문자열 or RegEx 가능)
2) 필터 Priority
: 모든 필터는 우선 순위(priority)가 있으며, 우선 순위가 높은 순서대로
필터에서 지정한 foreground color, background color가 적용되어 화면에 표시된다.
A가 가장 높은 우선 순위이며 이후 알파벳 순서로 적용된다.
(엄밀히 말하면 ASCII code순)
3) Show only filtered line mode (이하 ^H 모드)
: 단축키는 ^H 이며, 내가 생성한 필터들에 걸린 라인들만 화면에 표시하는 모드이다.
Excluding option이 걸린 필터가 enable 되어있는 경우가 있다면,
필터에 걸리긴 했어도 excluding option이므로
그 필터에 걸린 라인들은 화면에 표시하지 않는다.
3. Quick start guide
1) 먼저 텍스트 로그를 하나 열어보자.
(File 메뉴의 Open 선택 혹은 윈도 탐색기에서 파일을 끌고와 창 위에
올려놓는 Drag & Drop 사용)
2) 그러면 파일 내역(로그)이 위쪽 창에 주르륵 표시된다.
혹시 파일에 blank line이 다수 포함되어 있고, 보기에 거슬린다면 preference 메뉴에서
"Do NOT display blank line"을 선택해보자. 빈 줄은 모두 삭제되고 표시되니 좀 더 깔끔하다.
(TAT.NET에는 이런 기능 없다 ㅋㅋ)
3) 필터를 하나 만들어보자
(단축키는 Ctrl+N, 메뉴는 Filter / Create new filter )
3-1) 필터 생성 창이 나오면 아래의 정보를 입력한다
a) Label
그냥 레이블정도로 생각하면 된다. 이 필터의 쓰임새가 뭔지 간단히만 적는다.
TAT.NET에는 이런 항목이 없는데 이것을 추가한 이유는,
필터에 복잡한 Regular expression을 사용할 경우, 얼마 지나고 난 후 대체 내가 만든
이런 복잡한 RegEx filter가 도대체 뭘 찾으려고 만든것인지 잘 생각이
안나는 경우가 많아(머리가 나쁜 탓이다;;) label 항목을 추가한 것이다.
선택사항이므로 입력하지 않아도 무방하다.
b) Priority
최초 생성시 무조건 Priority A를 갖는다. (A가 가장 높음)
TAT.NET에서는 new filter가 항상 Priority가 가장 낮게 설정된다.
(하지만 왠지 이상했다. 내가 새로운 필터를 만든 이유는 뭔가
'새로운 것'을 찾아보고 싶어서 만든것인데 왜 항상 제일 낮은
priority를 가져야 하는지..)
새로 생성한 필터의 prirority를 최상위 (혹은 내가 원하는 적당 수준으로)
끌어올리기 위해 계속 1 step씩 올려야 하는 쓸데없는(?) 일을 반복했어야
했던 일이 정말 귀찮았고 그래서 이렇게 구현을 하였다.
c) Enable checkbox
최초 생성이므로 당연히 default는 enable에 체크되어 있다
d) Search Text
찾고자 하는 문자열을 입력한다.
일반 문자열의 경우 사용가능한 남은 문자열 개수를 표시해주며
RegEx의 경우에는 올바른 pattern인지 검사한 결과까지 함께 표시해준다
e) Excluding this search text checkbox
내가 찾고자하는 문자열이 들어간 라인을 '제외해주는' 역할을 한다.
보고 싶지 않은 라인이 있을때 체크하면 되며, 제외하는 역할을 하므로
foreground/background color는 지정하지 못하게 된다.
^H mode에서는 이 필터에 걸린 라인들은 화면에 보여주지 않는다.
(이 필터의 역할이 excluding 이므로)
f) Text color
이 필터에 걸린 문자열들의 foreground/background 색깔을 설정한다.
필터 신규 생성 dialog box에서 지정된 foreground color 값은
약 70여가지 색깔중 랜덤하게 선택하여 지정되므로, 맘에 안들때만
색깔을 바꿔주면 된다. (센스 만점! ㅋㅋ)
g) Search option
대소문자 구분과 Regular expression을 각각 선택할 수 있다.
참고로, Regular expression을 처음 들어봤다면 반드시 익혀 활용해
볼 것을 권한다. 대충 조금만 익혀도 Debugging 인생이 무척 편해진다. ㅋㅋ
4) 검색된 문자열이 변경된 색깔로 보이는 것을 확인해 볼 수 있을 것이다.
한 화면에서 잘 안보이는 경우에는 ^H 키를 눌러 "Show only filtered lines"
mode로 전환해 보자.
필터에 걸린 문자열들만 볼 수 있을 것이다.
화면에 아무것도 안보인다면 필터의 문자열에서 검색된 것이 아무것도 없는 것이다.
(설마 이 프로그램의 버그인가;;;)
5) 방금 생성한 필터를 수정하고 싶은 경우에는
Filter / Edit filter 메뉴를 선택하거나,
아래 필터창에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴에서 Edit this filter를
선택해보자.
6) 방금 생성한 필터의 priority만을 수정하고 싶은 경우에는
아래 필터창에서 마우스 오른쪽 버튼을 눌러 나오는 메뉴에서 Priority change를
선택해보자.
특정 priroity 값으로 "바로" 변경할 수 있다. TAT.NET에는 이런 기능 없다 ㅋㅋ
4. User interface
1) Log window
a) 단축키 사용
-. 필터 priority A에 걸린 라인으로 곧바로 현재 커서를 움직이고 싶을때는
키보드 'a' (소문자) 를 누른다.
-. 'a'를 누를때마다 priority A에 걸린 라인으로 계속 옮길 수 있다.
-. 반대방향(reverse direction) 으로 가고 싶으면 'A' (대문자)를 누른다.
-. 필터에 걸린 라인으로 곧바로 현재 커서를 움직이고 싶다면 'space' 키를
누른다. 필터 종류 상관없이 무조건 필터에 걸린 라인으로 옮길 수 있다.
-. 반대방향으로 움직이는 것은 지원하지 않는다. Shift+Space 키는
윈도에서 사용중인 한/영 전환키와 충돌하므로 굳이 구현할 필요성을 못느낀다.
그냥 PageUp 키와 눈으로 찾길 바란다;;
2) Preference 메뉴
: 여러가지 설정을 할 수 있다. mlak이 TAT.NET과 차별화 되는 포인트;;;
A) Log Text tab
a. Default font
기본 폰트 설정을 바꿀 수 있다.
TAT.NET에서는 지원하지 않지만, 개인적으로는 매우 중요하고 쓸모있는
기능이다;;
Bold type 글꼴을 선택해봤자 적용안되고 단지 font face와 size만 반영된다.
다 아는 얘기겠지만, 가능하다면 fixed-width font를 사용하는 것이
가독률을 높일 수 있다.
여기서 선택한 글꼴은 아래의 세군데에서 적용된다.
-. Log window의 로그 텍스트
-. 신규 필터 생성 및 편집 dialog box에서 Filter text 문자열
-. Search dialog box에서 search text 문자열
b. Default line color
그 어떤 필터에도 걸리지 않는 default line color를 변경할 수 있다.
c. Blank line
텍스트 파일에 빈 줄이 있을 경우 화면에 보여주고 싶다면 "display blank line"을
선택하면 된다.
"Do NOT display blank line"을 선택할 경우,
log window에 표시되는 라인번호(Line #)는 실제 그 파일 내의 원래 라인번호가
아니고 빈 줄을 모두 제외한 라인번호임을 명심한다. (그리 중요한 내용은 아니다)
d. Spaces for tab character
로그 텍스트 파일에 tab character가 있을 경우 변환할 space의 크기를 설정한다.
B) Filter tab
a. Default filter file
mlak 구동시 default로 읽어들일 filter file을 지정한다.
TAT.NET에서는 command line argument로 읽어들일 수 있도록 되어 있으나,
윈도 환경에서 입력하기란 꽤나 귀찮은 일일 수 있다.
그래서 추가한 기능이며, 쓸만하다 ㅋㅋ
b. Excluding option
Filter에서 excluding option을 선택할 경우, 그 filter에 걸린 라인들의
foreground/background color를 선택할 수 있다.
Excluding option에 걸린 라인들은
-. ^H 모드인 경우에는
(i) Non-excluding option 필터들이 하나라도 enable 되어 있을 경우에는
log window에서 보이지 않는다.
Non-excluding option 필터에 걸린 라인들만 보인다.
(ii) Non-excluding option 필터들이 enable 되어 있는 것이 전혀 없을 경우에도
log window에서 보이지 않는다.
대신 normal line(어느 필터에도 걸리지 않은 라인)이 보인다.
-. ^H 모드가 아닌 경우에는
log window에서 보이며 여기서 지정한 색깔로 출력된다.
fgcolor를 가능한 bgcolor와 비슷하게 적용할 경우 excluding option에 걸린
라인들은 희미하게 보이게 할 수 있으므로 원하는 취향대로 설정한다.
C) General tab
a. Clipboard copy
Log window에서 Ctrl+C를 누를 경우 현재 커서가 있는 라인 (혹은 선택한 전체
라인)을 모두 clipboard로 복사하는 기능이 있다.
"Do NOT append line nubmer text"를 선택하면 clipboard로 복사할 때
현재 라인의 텍스트만 복사한다.
"Append line number text"를 선택하면 현재 라인의 텍스트 앞에 라인번호도
추가하여 복사한다.
TAT.NET에서는 항상 라인번호를 앞에 붙여주는데, 가끔은 라인번호가
필요하지 않을때도 있었으므로 option으로 구현하여 취향에 맞추어 선택할
수 있게 하였다.
3) Copy & Paste
A) Copy to Clipboard
-. Log window에서 현재 라인 하나 (혹은 선택한 전체 라인)을
Ctrl+C를 누를 경우 clipboard로 복사해준다.
-. 메일 쓸때나 debugging시 해당 라인 텍스트를 별도로 메모할때
아주 유용한 기능이다.
B) Paste from Clipboard
-. Notepad나 다른 프로그램에서 텍스트를 선택해 복사해 둔 후
Ctrl+V를 누를 경우 log window에 그 텍스트를 그대로 가져온다.
-. QXDM의 air message나 다른 로그를 복사해와 볼 때 아주 유용한 기능이다.
5. 기타 사항
1) TAT.NET 필터 import 기능
-. 메뉴에서 File / Import .. 를 선택하여 기존에 사용하던
TAT.NET 필터를 가져오는 기능이다.
-. 당연히 지금까지 쓰던 TAT.NET 필터를 쓸 수 있어야 하지 않겠는가...
2) TAT.NET 대비 미진한 기능
A) Bookmark
-. 현재 구조상 기능 구현이 약간 어렵다. 실력이 딸린탓이다;;
-. 그리고 실제로 본인도 별로 쓰지 않던 기능이어서 굳이 구현할 필요성을
못느낀다;;
B) 대용량 파일 loading
-. 이건 어떻게 구현하는지 잘 몰라 못하고 있고;;
도움을 줄 사람을 찾고 있으므로 언제든지 연락 요망.
===============================================================================
| License |
===============================================================================
Freeware
===============================================================================
| Bug Reports |
===============================================================================
Name : Hwang Minjae
E-mail : minnznt@gmail.com
-. 에러가 발생한 내역에 대해 자세히 알려주세요.
-. 에러가 발생한 파일도 같이 보내주세요.
/* END of README */
