개발자언어(주석달기 위한 영어)

주석은 주로 한글로 달지만(한글로 달아도 나중에는 뭔 소리인지 모를때가 있기 때문에) 외국쪽에 소스를 오픈해야 할때에는 영어 주석이 필수이다.
따라서, 구구절절 달지는 못해도 주로 간단하게 사용할만한 표현만 정리해 보았다.
주로 st 마이크로프로세서에서 제공하는 소스주석을 보고 공부하였다.

▷ 입력버퍼에 관한 pBuffer포인터 : pBuffer pointer to the input data buffer
▷ char타입을 가진 입력버퍼 포인터 : input buffer pointer with char type.
▷ 실제 타이머는 인트럽트 루틴에서 구현된다 :
  → actual timer is implemented in the interrupt routine.
이전 타이머 : the previous timer value.
▷ 이전 타이머 값과 새로 들어온 타이머값을 조합하여 ㅇㅇㅇ
  → ㅇㅇㅇ using combination of the previous timer value and the new one
▷ 전송할 바이트 수 가져오기(전송을 위해서 구성된 바이트 수)
  → Get the number of bytes configured for transfer
▷ 변수를 설명할 때 자주 사용하는 표현
  function(char aaa)
  aaa : this parameter
▷ START비트가 1일때, 이 비트들을 변경하면 안된다.(변경하는 것이 허락되지 않음)
  → Changing these bits when START bit is set is not allowed
▷ data length와 data size : 주로 2개를 혼용해서 사용하는 것 같다.
  원문주석 코드를 보면
  → length : 주로 16비트 데이터 길이와 같이 비트가 들어갈때 자주 사용.
     물론 데이터 길이에서도 length도 사용하였기에 조금 더 볼 필요가 있다.
  → size : 우리가 말하는 전체 데이터 사이즈를 말할때.
   예) SPI data size, DMA Memory data size,
▷ 전체 버퍼 길이 : Total Buffer Length 또는 the total length of the buffer
▷ 전체 버퍼을 읽어라 : Read the whole buffer.
▷ 남아 있는 바이트 수(어떤 연산이나 조작을 하고 남아 있는 바이트) :
  → the number of remaining bytes.
▷ 출력버퍼에 맞는(맞춘) 최대 메세지 크기 :
  → the maximum message size that fits in the output buffer.
▷ flag에 1로 셋팅 : set flag to 1.
▷ A에서 출력 버퍼로 복사 : copy A into the output buffer.
▷ 수신 데이터 : the received data.
▷ 장치로 부터 데이터를 읽는 방법은 : The way data is read out of the device is ~~
▷ 읽을 레지스터를 지정하는 것 : specifying which register is to be read
▷ 의 63%를 달성하는데 걸리는 시간 : Time for achieving 63% of ~
▷ 데이터 배열 data_pau8에 복사할 바이트수 : Number of bytes which are copied to data array data_pau8.



댓글 없음:

댓글 쓰기

왜 낮은 음을 화음으로 연주하면 불편하게 들릴까?

C코드의 경우에는 도,미,솔이라는 3가지 음으로 구성된다. 피아노나 기타로 연주하면 전혀 불편함 없이 아름답게 들린다. 그런데 더블베이스(베이스기타)로 도,미,솔을 누르고 연주하면 뭔가 불협화음처럼 들린다. (피아노에서도 낮은 옥타브에서 C코드를 치면...