구차니의 잡동사니 모음

cvs와 svn을 사용하면서 느끼는 점은, 우열을 가리긴 모호하다는 것이다.
cvs가 나은점도 있고, svn이 나은점도 있고,
이러한 모호함 때문에 일단 회사 개발소스는 cvs로 유지중이긴 하지만...


거두절미하고, svn은 cvs의 단점을 개선하기 위해 만들어진건데
가장 큰 변경사항은 svn에서 디렉토리 이동이 편해졌다는 점이다.
cvs은 특정 소스의 위치를 변경하거나, 하위 디렉토리의 위치를 변경하기 위해서는
소스를 새로운 곳에 새롭게 Add 하고 기존의 파일을 Delete 해야 해서
이력추적을 할 수 없게 되지만, svn에서는 이력추적이 가능해진다.


일단 사소한 것들을 고고싱 (기준은 CVS)

SVN의 장점

1. 디렉토리 이동이 편리함
    안정화된 프로젝트라면 상관없지만, 프로젝트 초기에는 디렉토리 이동이나 파일 삭제/이름 변경이 빈번한데
    cvs는 이러한 이력을 남길수가 없기 때문에, 초기 프로젝트 셋업시에는 svn이 매우 편리함.
    (이동도 편리하지만, 그에 비해 이력이 따라와서 과거의 변경점이 유지 된다는 부가적인 장점)

2. 오프라인 사용이 용이함
    확실하게 어느정도까지 오프라인 사용이 가능한지는 모호하지만, 최소한 마지막 버전과 Diff가 가능하다.
    cvs에서는 항상 서버와 비교를 하기 때문에 소스 변경사항이 있는건 알아도
    어떤 내용이 서버와 차이가 있는지 알수 없지만, svn 에서는 오프라인에서도 diff가 가능함
    (svn 자체적으로 데이터를 유지하고 있음 = 받는 측 용량 부담 증가)

3. 서버 하드공간이 절약됨
    cvs을 cvs2svn으로 변환해본 결과 대략 25% 이상의 공간이 절약됨
    초기 업로드는 원본으로 올리지만, diff 내용들을 gzip으로 압축하므로 서버 공간 요구량이 줄어듦
    2009/05/11 - SVN과 CVS 저장소 용량비교(compare Repository Size of CVS & SVN)

4. 커밋마다 revision이 올라감
    하나의 변동사항이나, 복수의 파일을 한번에 commit 하면 revision이 변동되고,
    프로젝트 전반적인 변동사항을 추적하기 편리함.
    cvs는 파일단위 revision이기 때문에 프로젝트 전체의 변동이나
    "어떤 파일이 변경되기 이전 시점"으로 롤백하기 매우 난해하나
    svn에서는 commit 단위로 revision이 붙으므로, 잘못 commit 하더라도 복구가 용이함
    (부가적으로 cvs에 비해서 프로젝트 전반적인 변경의 흐름을 읽기 쉬움)

5. atomic commit
    atomic 은 DB에서 하나의 행동의 묶음이 완결되지 않으면 수행되지 않은것으로 복구가 되는 것을 의미하는데
    cvs에서 아무생각없이 commit에서 변동사항들을 본다고 하다가 commit 눌러 올려서 도중에 cancel 했지만
    몇개는 변경되어 난감한 상황을 겪어봤다면 이 녀석의 유용함을 깨달을 수 있다.



SVN 단점

1. 서버 구성이 괴랄하다
    무슨 svn 제대로 쓰려면 apache까지 깔아야 해?
    로그를 남기기 위해서는 svn 자체적으로는 로그가 안남으므로 apache의 로그나 인증을 이용해야 함.
    관리자 측면에서 로그가 남지않는다는건.. 좀 불안해진다.
    (머...... 사용자는 서버 관리자의 고충은 알바없지?)

2. tag 관리가 밋밋함
   너무 많은 자유는 없는것과 다름 없다지만.. svn의 표준(?) repository는 아래와 같이 구성한다.
   2009/05/11 - SVN repository 구조

   개별 프로젝트 별로 trunk / branches / tag를 관리하고
   tagging을 위해서 전체 프로젝트를 tag 하위 디렉토리로 tag 번호를 붙여 복사해주면 된다.
   어쩌면 매우 간편하지만, cvs의 정말 꼬리표를 붙인다는 작업에 비하면 아쉬운 면이 있다.
   cvs에서는 tagging을 하려면 서버와 local의 내용이 동일해야 하고, tagging시 변동 파일이 하나라도 있으면 붙일수 없어
   업데이트 되지 않는 파일이 있는지 빼먹지 않을수 있는 여지가 있지만, svn은 서버에서 클라이언트를 보지 않고
   작업이 가능해지므로 업데이트 되지 않은(혹은 누구가 그 순간 올린 내용까지) 부분이 빼먹거나 더 들어갈수 있다.
   개인 취향이겠지만, tag는 cvs의 약간은 딱딱하고 붙이는 맛이 있는 것이 좋다고 생각한다.

3. repository 구성의 모호함
   repository는 위와 같이 구성하려면 svn 사용자는 /calc /paint 두개의 repository를 기억해야 한다.
   commit 별로 revision이 증가하는 장점의 역효과로서, 단일 프로젝트레 단일 repository를 보장해주어야 제 힘을 발휘한다.
   서로 연관이 있는 두개의 프로젝트라고 하더라도 되도록이면 프로젝트를 분리하는 것이 좋다.
   (현재까진 상위 디렉토리의 목록을 (= 프로젝트 목록) 얻어내는 법을 모르겠다.)

   /home/svn을 만들고
   /home/svn/calc 에 create repository
   /home/svn/paint 에 create repository 를 하고
   svn에서는 /home/svn/calc , /home/svn/paint가 있음을 외우고 써야한다.
   (/home/svn에 접속하면 리파지터리를 알 수 없으므로 에러가 발생한다.)

Welcome to CMake, the cross-platform, open-source build system. CMake is a family of tools designed to build, test and package software. CMake is used to control the software compilation process using simple platform and compiler independent configuration files. CMake generates native makefiles and workspaces that can be used in the compiler environment of your choice. [링크 : http://www.cmake.org/]

oscam을 컴파이르 하는데 cmake 라는것을 요구하길래 먼가해서 검색해 봤더니
cross platform을 지원하는 make 라고 한다.

사용법은
cmake
make 라는데

configure 와 유사한 역활을 하는것으로 보인다.

mysql 실행하기
mysql -uUSERID -pPASSWORD

mysql 종료하기
quit
exit
ctrl-D

데이터베이스(database) > 테이블(table)
생성(create) / 삭제(drop)

블로그나 wiki 설치을 위한 데이터베이스 생성
create database DATABASENAME;

목록보기(show)
show databases;
use DATABASENAME;
show tables;

데이터베이스 삭제
drop DATABASENAME;

[링크 : http://mulsoft.com/site/bbs/board.php?bo_table=mulsoft04&wr_id=1&sca=USER]

makefile에서

OBJS = a.o b.o SRC = $(OBJ:.o=.c) a.o : a.c b.o : b.c

이런식으로 파일을 일일이 나열을 하는데, 아무래도 귀찮다 -ㅁ-!

하지만 $(wildcard) 라는 함수를 이용하면 나열은 하지 않아도 된다.

SRC = $(wildcard *.c) OBJ = $(SRC:.c=.o)

이렇게 하면 (의존성은 제외하더라도) 복잡하게 할 필요 없이 간단하게 끝!

[링크 : http://www.viper.pe.kr/docs/make-ko/make-ko_4.html#SEC21]

APM을 설치하고
보안 기본설정에서 http://localhost 로 접속하면 인트라넷 보안수준으로 접속을 하는데
텍스트큐브 로그인이 되지 않는다.(로컬에 설치한 텍큐)

http://127.0.0.1 로 접속하면 인터넷 보안수준으로 접속하는데,
이 경우에는 텍스트큐브 로그인이 된다.


음.. IE8 문제일까? 텍큐 문제일까?

만우절 이벤트로 안되게 했을리는 없고..
머가 바뀌걸까?

expat xml 파서를 이용해서 xml을 구조화시키는(간단하게 탭정렬) 것을 하다보니, data 부분에서 파싱에러가 발생한다.
URL 등에서 &가 & 로 변환되지 않았다고
"세미콜론이(;)이 와야 합니다." 라는 문법오류가 발생한다.

아무튼 expat의 기본샘플 프로그램(?)인
xmlwf.c의 내용을  보니 별도로 이러한 특수문자를 처리하는 함수가 있었다.

static void XMLCALL
characterData(void *userData, const XML_Char *s, int len)
{
  FILE *fp = (FILE *)userData;
  for (; len > 0; --len, ++s) {
    switch (*s) {
    case T('&'):
      fputts(T("&"), fp);
      break;
    case T('<'):
      fputts(T("<"), fp);
      break;
    case T('>'):
      fputts(T(">"), fp);
      break;
#ifdef W3C14N
    case 13:
      fputts(T("&#xD;"), fp);
      break;
#else
    case T('"'):
      fputts(T("""), fp);
      break;
    case 9:
    case 10:
    case 13:
      ftprintf(fp, T("&#%d;"), *s);
      break;
#endif
    default:
      puttc(*s, fp);
      break;
    }
  }
}

아무튼, 많이 보던 녀석인데 도대체 어떤 표준인지 알수가 없는데,
검색하다 보니 iso8859-1 인것 같기도 하고.. 구분이 모호하다.
아무튼, XHTML/HTML에서 사용되는 방식인듯 하다.

Reserved Characters in HTML Some characters are reserved in HTML and XHTML. For example, you cannot use the greater than or less than signs within your text because the browser could mistake them for markup. HTML and XHTML processors must support the five special characters listed in the table below: Character Entity Number Entity Name Description " &#34; &quot; quotation mark ' &#39; &apos; (does not work in IE) apostrophe  & &#38; &amp; ampersand < &#60; &lt; less-than > &#62; &gt; greater-than Note: Entity names are case sensitive! [링크 : http://www.w3schools.com/tags/ref_entities.asp]

[링크 : http://microweb.textcube.com/31]

make를 이용하여 컴파일할 소스들의 목록을 작성할때

# cat Makefile OBJS-$(CONFIG_AAC_DEMUXER)               += raw.o id3v1.o id3v2.o OBJS-$(CONFIG_AC3_DEMUXER)               += raw.o OBJS-$(CONFIG_AC3_MUXER)                 += raw.o

위와 같이 OBJS에 += 로 계속 더해나가다 보면
raw.o 가 여러개 붙어지고, 이 상태로 컴파일을 하면 symbol들이 중복되어

Function funcname() is deprecated in path/filename.ext on line 00

이런식으로 에러를 발생한다.
이를 간편하게 해결하기 위해서는 sort를 이용하면 된다.
sort는 중복된 내용을 제거해주는 역활도 한다.

$(sort list)     Sorts the words of list in lexical order, removing duplicate words.     The output is a list of words separated by single spaces. Thus,               $(sort foo bar lose)              returns the value `bar foo lose'.     Incidentally, since sort removes duplicate words,     you can use it for this purpose even if you don't care about the sort order.

[링크 : http://www.gnu.org/software/make/manual/make.html#Text-Functions]
[링크 : http://korea.gnu.org/manual/4check/make-3.77/ko/make_8.html#SEC76]

expat은 handler를 기반으로 작동한다.
특정 이벤트에 작동하는 핸들러를 등록하여 그 값을 뺴내는데
이벤트(?)는 아래의 SetHandler 함수로 등록을 한다.

StartElement는 <tag>
EndElement는 </tag> 에
대해서 값을 받아 오도록 한다.

Handler Setting Functions XML_SetStartElementHandler XML_SetEndElementHandler XML_SetElementHandler XML_SetCharacterDataHandler XML_SetProcessingInstructionHandler XML_SetCommentHandler XML_SetStartCdataSectionHandler XML_SetEndCdataSectionHandler XML_SetCdataSectionHandler XML_SetDefaultHandler XML_SetDefaultHandlerExpand XML_SetExternalEntityRefHandler XML_SetExternalEntityRefHandlerArg XML_SetSkippedEntityHandler XML_SetUnknownEncodingHandler XML_SetStartNamespaceDeclHandler XML_SetEndNamespaceDeclHandler XML_SetNamespaceDeclHandler XML_SetXmlDeclHandler XML_SetStartDoctypeDeclHandler XML_SetEndDoctypeDeclHandler XML_SetDoctypeDeclHandler XML_SetElementDeclHandler XML_SetAttlistDeclHandler XML_SetEntityDeclHandler XML_SetUnparsedEntityDeclHandler XML_SetNotationDeclHandler XML_SetNotStandaloneHandler [링크 : http://www.hpc.wm.edu/SciClone/documentation/software/misc/expat/reference.html]

머.. 일단 실행은 해보고 -ㅁ-?
Start와 End는 확실한데.. 다른건 좀 일단 실험을... ㅠ.ㅠ

XML_SetElementHandler 는 XML_SetStartElementHandler 보다 우선하고,
static void XMLCALL ElementHandler (void *userData, const XML_Char *name, const XML_Char **atts)
에서 name은 XML_SetStartElementHandler 에서 리턴하는 것과 같고
atts는 몇 개인지 알수는 없으므로  atts[idx] != NULL 일때 까지 돌리는수 밖에 없다.

원본데이터
<ns0:feed xmlns:ns00="http://www.w3.org/2005/Atom">

결과물
name[ns0:feed]
atts[xmlns:ns0] atts[http://www.w3.org/2005/Atom]

atts[idx]

doxygen은 html / pdf / rtf / xml 타입으로
함수들의 목록이나 사용방법 메뉴얼을 만들어 주는 독한 녀석이다.
가장 익숙한 유사한 녀석은
API tree view인데
[링크 : http://java.sun.com/j2se/1.4.2/docs/api/]

이런녀석이 doxygen 류의(자바는 javadoc 이라고 자체 지원하는듯) 프로그램을 통해 자동 생성되는 녀석이다.
이런걸 왜하나면.. 프로그램 문서화의 일환이기도 하고, 좋게 말하면 인수인계 안하고
"소스를 보면 다 보이르니라~" 라고 발빼기 편하기 위함이다.(응?)


doxygen은 굳이 doxygen 문법으로 주석을 달아주지 않아도, 일단 생성은 해준다.
자세한 사용방법이나 설명서는 별도로 주석에 포함하여 작업을 해주어야 하지만 말이다.

Step 1. Project 탭
            Doxygen을 실행시키면 아래와 같은 화면이 나오고
           "Step 1:Specify ..." 부분에 프로젝트 루트의 경로를 입력한다.
            그리고 Project name / version or id 에는 임의로 넣어주어도 되니 대충 패스
            source code directory 에는 프로젝트 루트를 입력하고 "Scan recursively"를 반드시 체크해야
            빠짐없이 소스를 검색해서 api 문서를 작성해준다.
            Destination directory는 생성된 html 이나 pdf 파일이 저장될 위치로,
            프로젝트 내에 doc 폴더를 만들거나, 다른 경로로 지정해주어도 무방하다.

            단, 경로명에 한글을 지원하지 않으므로,
            중간에 "바탕 화면" 이런게 들어가면 작동하지 못하니 경로를 옮겨야 한다.


Step 2. Mode 탭
           출력될 내용을 고르는 것으로, 많은 양의 출력을 원하면 아래와 같이
           All Entities / Include cross-referenced source code in the output을 선택한다.
           그리고 doxygen이 인식할 언어를 고르는 건, 프로젝트의 언어에 맞게 골라주면 된다.


Step 3. Output 탭
           이 탭은 결과물을 어떤형식으로 저장할지에 대한 부분이다.
           HTML은 원래 웹에서 사용하는 용도로 만들어지긴 하지만,
           가장 알록달록해서 HTML로 저장해서 로컬에서 봐도 꽤 유용하다.
           API 탐색에 익숙한 tree 구조로 만들어주는게 좋기에 "with frames and a navigation tree" 를 추천한다.
           아무튼, 지원하는 문서 형식은 HTML / PDF(LaTeX) / RTF(word) / Manpage(Linux help) / XML 이다.


Step 4. Diagram 탭
           이녀석은 다른 작업을 해야 하는지 모르겠지만, GraphViz 는 별도의 패키지를 깔아야 하고
           built-in은 독립적으로 생성이 가능하다는 차이가 있다.(결과물은 당연히 GraphViz가 좋을듯?)


Step 5. Run
           솔찍히.. Next만 죽어라 누르다가 계속 누르면 만들어 지겠지.. 했는데 안만들어져서 한참을
           찾다보니 겨우겨우 "Run doxygen" 이라는 버튼이 발견되었다. ㄱ-
           아무튼 설정을 다하고 Run 버튼을 누르면 문서 생성이 시작된다.


[링크 : http://www.stack.nl/~dimitri/doxygen/] doxygen 공식 홈페이지
[링크 : http://www.stack.nl/~dimitri/doxygen/download.html#latestsrc] 다운로드 링크
[링크 : http://www.graphviz.org/Download_windows.php] 그래프 그려주는 plugin(?)

[링크 : http://jwmx.tistory.com/1496]