구차니의 잡동사니 모음

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]

아래와 같이 localhost:6010에 대한 주소를 받아오지 못한다고 에러가 나면
/etc/hosts 파일이 존재하는지 확인을 해야한다.

$ gedit _X11TransSocketINETConnect() can't get address for localhost:6010: Name or service not known cannot open display: Run 'gedit --help' to see a full list of available command line options.

파일이 존재한다 하더라도, 내용이 없다면 내용을 추가해준다.

$ cat /etc/hosts # Do not remove the following line, or various programs # that require network functionality will fail. ::1     localhost.localdomain   localhost

expat-2.0.1 에 포함되어있는 예제파일인
elements.c를 약간 변형하여

XML tag로 출력되도록 약간 수정하였다.
컴파일에 필요한 libexpat.lib 파일과 expat.h 파일
그리고 테스트용 XML 파일(youtube page)가 포함되어있다.
(libexpat.lib는 내부적으로 libexpat.dll을 호출하는 것으로 보인다.)

/* This is simple demonstration of how to use expat. This program
reads an XML document from standard input and writes a line with
the name of each element to standard output indenting child
elements by one tab stop more than their parent element.
It must be used with Expat compiled for UTF-8 output.
*/

#include "stdio.h"
#include "expat.h"

#if defined(__amigaos__) && defined(__USE_INLINE__)
#include "proto/expat.h"
#endif

#ifdef XML_LARGE_SIZE
#if defined(XML_USE_MSC_EXTENSIONS) && _MSC_VER < 1400
#define XML_FMT_INT_MOD "I64"
#else
#define XML_FMT_INT_MOD "ll"
#endif
#else
#define XML_FMT_INT_MOD "l"
#endif

static void XMLCALL
startElement(void *userData, const char *name, const char **atts)
{
	int i;
	int *depthPtr = (int *)userData;
	for (i = 0; i < *depthPtr; i++)
		putchar('\t');
	printf("<%s>\n",name);
//	puts(name);
	*depthPtr += 1;
}

static void XMLCALL
endElement(void *userData, const char *name)
{
	int i;
	int *depthPtr = (int *)userData;
	*depthPtr -= 1;
	for (i = 0; i < *depthPtr; i++)
		putchar('\t');
	printf("</%s>\n",name);
	//	puts(name);
}

int
main(int argc, char *argv[])
{
	FILE *fp;
	char buf[BUFSIZ];
	XML_Parser parser = XML_ParserCreate(NULL);
	int done;
	int depth = 0;
	
	fp = fopen("GetRecentlyFeaturedVideoFeed.xml","r");
	
	XML_SetUserData(parser, &depth);
	XML_SetElementHandler(parser, startElement, endElement);
	do {
		int len = (int)fread(buf, 1, sizeof(buf), fp);
		done = len < sizeof(buf);
		if (XML_Parse(parser, buf, len, done) == XML_STATUS_ERROR) {
			fprintf(stderr,
				"%s at line %" XML_FMT_INT_MOD "u\n",
				XML_ErrorString(XML_GetErrorCode(parser)),
				XML_GetCurrentLineNumber(parser));
			return 1;
		}
	} while (!done);
	XML_ParserFree(parser);
	fclose(fp);
	return 0;
}

expat은 c언어로 작성된 XML 파서이다.
음.. c라고는 하지만, python 2.6 에서는 expat을 기본 XML 파서로 내장한다.

아래는 expat 홈페이지와, c에서 expat을 사용하는 예제들이 들어있다.
링크만 발견하고 실제로 사용해보진 못했지만,
handler역활을 하는 함수를 추가하여,
그 함수들을 태그의 시작이나 끝 그리고 데이터 부분에서 호출하게 되는것으로 보인다.

[링크 : http://expat.sourceforge.net/]
    [링크 : http://www.vivtek.com/xmltools/]
    [링크 : http://www.joinc.co.kr/modules/moniwiki/wiki.php/Site/XML/expat_xml]

python2.6의 expat 예제
실제로 windows에서 2.6으로 돌려보니 결과가 조금 다르게 나왔다.
원래 문서에는 출력된 문자열 앞에 u가 붙어있지 않다.(unicode 문자열을 알리는 접두?)

>>> p.Parse("""<?xml version="1.0"?> ... <parent id="top"><child1 name="paul">Text goes here</child1> ... <child2 name="fred">More text</child2> ... </parent>""", 1) Start element: parent {u'id': u'top'} Start element: child1 {u'name': u'paul'} Character data: u'Text goes here' End element: child1 Character data: u'\n' Start element: child2 {u'name': u'fred'} Character data: u'More text' End element: child2 Character data: u'\n' End element: parent 1

[링크 : http://docs.python.org/library/pyexpat.html]